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yo kotikäytössä olevista mikrotietokoneista suurta osaa käytetäänkin 
vain pelien pelaamiseen, on koneiden omistajista suuri osa kiinnostunut 
myös ohjelmoinnista. Vaikka Basic onkin lähes poikkeuksetta ensimmäinen 
opittu ohjelmointikieli, innokkaat harrastajat käyttävät paljon myös muita kieliä. 
Basic on helppo oppia ja esimerkiksi Amigassa sillä pystyy hallitsemaan melko 
hyvin koneen kaikkia ominaisuuksia kehittyneen Basic-tulkin ansiosta. 

Basicin haittapuolet alkavat vaivata siinä vaiheessa, kun kieli on suurin piir- 
tein opittu. Suurin haitta on yleensä kielen hitaus. Itsenäisten ohjelmien tekemi- 
nen AmigaBasicilla ei onnistu, vaan niiden ajamiseen tarvitaan aina Basic-tulk- 
ki. Tarkkaa ajoitusta vaativien ohjelmien teko on vaikeaa, jopa mahdotonta. Kie- 
len monipuolisimmatkin toiminnot asettavat johonkin rajat, joita on vaikea ylit- 
tää. Lisäksi Basic-ohjelmoijat leimautuvat Pascal-, C- ja assemblerohjelmoijien 
keskuudessa aloittelijoiksi, olivatpa aikaansaannokset millaisia hyvänsä. 

Jos halutaan tunkeutua ohjelmoitaessa suoraan koneen ytimeen on ohjelmoin- 
tikieleksi yleensä valittava assembler eli konekieli. Sen avulla koneesta saadaan 
irti se, mitä saatavissa on. Tietysti assembleria käyttäenkin voidaan tehdä huono- 
ja ja hitaita ohjelmia, viime kädessä tulos riippuu aina enemmän ohjelmoijasta 
kuin ohjelmointikielestä. 

Tämä kirja käsittelee Amigan assemblerohjelmoinnin perusteita. Kirja ei edel- 
lytä aikaisempaa tietoa Amigan ohjelmoinnista, mutta jonkin assemblerkielen 
tuntemus helpottaa asioiden omaksumista huomattavasti. 

Kirja jakaantuu viiteen varsinaiseen lukuun. Ensimmäinen luku esittelee joita- 
kin assemblerohjelmointiin liittyviä käsitteitä, kuten lukujärjestelmiä ja Amigan 
rakennetta. Toisessa luvussa keskitytään Amigassa käytettyyn MC68000-mikro- 
prosessoriin ja sen ominaisuuksiin ohjelmoijan kannalta. 

Kolmas luku esittelee Amigan käyttöjärjestelmää ja sen käyttöä yleensä. Nel- 
jännessä luvussa tutustutaan yksityiskohtaisesti useisiin tärkeisiin käyttöjärjestel- 
märutiineihin. Viides luku esittelee Amigan assemblerkääntäjiä ja antaa siten 
käytännön valmiudet ohjelmointiin. Mukana ovat myös ohjeet kirjan mukana tu- 
levan monitoriohjelman käyttöä varten. Luvun lopussa käsitellään Amigan käyt- 
koja omista ohjelmista. 

Liitteissä käydään läpi kaikki MC68000-prosessorin käskyt, kaikkien käyttö- 
järjestelmärutiinien kutsuminen ja Amigan kovon muistikartta. Lisäksi esitel- 
lään vakioita määrittelevät include-tiedostot, ohjelmoinnissa hyödyllistä kirjalli- 
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suutta sekä sananselityksiä. 

Kirjan mukana tulevalla levykkeellä on ohjelmointiin liittyviä esimerkkejä, 
Monitori-ohjelma, include-tiedostot ja paljon muuta. Luonnollisesti myös kaikki 
kirjan esimerkkiohjelmat löytyvät levykkeeltä. 

Lopuksi haluan esittää parhaat kiitokseni Timo Rossille Monitori-ohjelman 
luovuttamisesta yleiseen levitykseen kirjan mukana sekä veljelleni Tomille kir- 
jan kuvituksesta. 

Tervetuloa Amigan assemblerohjelmoinnin lumoavaan maailmaan! 


Siilinjärvellä 10. lokakuuta 1988 
Jukka Marin 


Ohjelmointikielistä 


Ohjelmointikielistä 


A 


== 


ja B BRRRLSREGRS 


o alkuaikoina ei tarvinnut kauaa miettiä, millä kielellä konetta 
ohjelmoisi. Konekieli oli nimittäin ainoa vaihtoehto ennen ensimmäisten 
kääntäjien kehittämistä. Nykyisin tilanne on lähes päinvastainen: Jokainen ohjel- 
moija käyttää eri kieltä ja kehuu sitä maasta taivaaseen. Lieneekö maailmassa 
ketään, joka osaisi edes nimetä kaikki käytössä olevat ohjelmointikielet. 

Kaikilla ohjelmointikielillä on omat etunsa ja hyvät puolensa. Nykyisistä kie- 
listä suuri osa on kehitetty omaan tiettyyn käyttötarkoitukseensa eivätkä ne juuri 
sovellu muuhun. Osa taas on eräänlaisia peruskieliä, jotka soveltuvat yhtä hyvin 
(tai huonosti) kaikenlaisiin tehtäviin. Suosituimpia ohjelmointikieliä ovat Basic, 
Pascal ja C-kieli. Näistä C-kieli edustaa matalinta, koneläheisintä tasoa, vaikka 
se poikkeaakin vielä melkoisesti assemblerkielestä. C-kieli on yleistymässä sekä 
harrastajien että ammattilaisten keskuudessa. Sen etuja ovat korkean tason kielil- 
le tyypillinen rakenteinen ohjelmointi, mutta myös mahdollisuus toimia tehok- 
kaasti bittitasolta lähtien. Siksi C:tä käytetään paljon esimerkiksi käyttöjärjestel- 
mien ohjelmointiin. Yksi tunnetuimmista esimerkeistä on UNIX-käyttöjärjestel- 
mä. Myös suuri osa Amigan käyttöjärjestelmästä on kirjoitettu C-kielellä. 

Kaikille korkean tason kielille on yhteistä se, että tiettyyn päämäärään pääs- 
täkseen tietokone joutuu aina tekemään enemmän tai vähemmän turhaa työtä. 
Tämä johtuu siitä, että tehokkainkaan kääntäjä ei pysty voittamaan kokenutta as- 
semblerohjelmoijaa konekielisen koodin nopeudessa ja koossa. Korkean tason 
kielten käytön etuna on ohjelmien nopeampi kehittäminen ja helpompi testaami- 
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nen. Koska tietokoneiden teho kasvaa jatkuvasti, voidaan yhä useammissa sovel- 
luksissa käyttää korkean tason ohjelmointikieliä assemblerin sijasta. Lisäksi uu- 

simmat mikroprosessorit on usein suunniteltu korkean tason kielten vaatimusten 
mukaisesti, jolloin prosessorin teho saadaan hyvin hyödynnettyä myös näitä kie- 
liä käyttäen. 

Nopeutta vaativissa tehtävissä assemblerkieli puolustaa edelleen paikkaansa. 
Kun tietokoneesta halutaan puristaa irti viimeinenkin tehopisara, on assemblerin 
käyttö välttämätöntä. Haluttaessa lyhyttä ja tiivistä koodia assembler on paras 
vaihtoehto. Keskeytysrutiinit ja muut ohjelman osuudet, joita suoritetaan toistu- 
vasti, kannattaa usein kirjoittaa assemblerilla. Jos ohjelman kehittämiseen kulu- 
va aika ei ole ratkaiseva tekijä, assemblerin käyttö on järkevää myös monissa 
muissa tapauksissa. 

Tässä kirjassa käsitellään vain assemblerohjelmointia. Kuten myöhemmin 
huomataan, Amigan kehittyneen ja monipuolisen käyttöjärjestelmän sekä 
MC68000:n tehokkaan käskykannan ansiosta assemblerohjelmointikaan ei vält- 
tämättä vaadi suunnattomia ponnistuksia. Kun Amigan ohjelmointiin pääsee si- 
sälle, se on paljon helpompaa kuin useiden 8-bittisten koneiden, kuten C-64:n. 
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J asian oppimisen kannalta on tärkeää, että ymmärtää perusteet ja ter- 
mit oikein. Itse assemblerkieltä on turha yrittää opiskella ennenkuin tuntee 
peruskäsitteet, kuten muistipaikka, rekisteri, bitti, tavu, lippu jne. Käydään aluk- 
si hieman läpi ohjelmointiin läheisesti liittyvää sanastoa. 


Anteeksi, puhutteko konekieltä? 


Mikroprosessorin konekieleksi kutsutaan sitä kieltä, jota prosessori ymmärtää 
suoraan ilman kääntäjä- tai tulkkausohjelmia. Esimerkiksi Basic-tulkki toimii 
eräänlaisena sanakirjana, jonka avulla prosessori pystyy suorittamaan Basic-kie- 
listä ohjelmaa. Ohjelman suoritus sujuu kuitenkin hitaasti, koska prosessori ei 
ymmärrä ohjelmaa sellaisenaan. Kääntäjien tarkoitus taas on kääntää alkuperäi- 
nen ohjelma konekieleksi, jolloin prosessori pystyy suorittamaan ohjelmaa il- 
man sanakirjan selailua. Käännetyt ohjelman toimivatkin yleensä huomattavasti 
tulkkeja nopeammin. 
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Alimmalla tasolla konekielen voidaan ajatella olevan sarja binäärilukuja, jois- 
ta osa vastaa konekielisiä käskyjä ja osa käskyjen parametreja. Koska binäärilu- 
vut ovat ihmisen kannalta erittäin vaikeaselkoisia ja koska ohjelman kirjoittami- 
nen ja korjaileminen olisi niitä käyttäen lähes mahdotonta, on kehitetty ohjel- 
mointia helpottavia keinoja. 

Yksi parhaista keksinnöistä on assemblerkieli. Siinä konekielikäskyt on kor- 
vattu huomattavasti havainnollisemmilla kirjainyhdistelmillä. Assemblerohjel- 
mat voidaan kirjoittaa Basic- tai Pascal-ohjelmien tapaan normaalia tekstiedito- 
ria käyttäen. Kun ohjelma halutaan suorittaa, assemblerversio on ensin käännet- 
tävä konekieleksi, jotta mikroprosessori ymmärtäisi sitä. Kääntäminen tapahtuu 
yleensä assemblerkääntäjällä, joka hoitaa kääntämisen automaattisesti ja yleensä 
mahdollistaa symbolisten (selväkielisten) nimien käytön muistipaikoille, alioh- 
jelmille ja muille kohteille. 

Amigan kääntäjiä ja niiden toimintoja tarkastellaan lähemmin luvussa Assem- 
blerkääntäjistä. 


Lukujärjestelmät 


Tietokonetekniikassa käytetään tavanomaisen kymmenjärjestelmän lisäksi 
useita muita lukujärjestelmiä. Seuraavissa kappaleissa käydään lyhyesti läpi niis- 
tä yleisimmät. 


Binäärijärjestelmä 

Koska tietokoneet käsittelevät tietoa binääri- eli kaksijärjestelmän lukuina, on 
välttämätöntä tuntea tämän järjestelmän luvut ja laskusäännöt. Kaksijärjestel- 
män luvut muodostuvat ykkösistä ja nollista. Niissä esiintyy siis vain kahta nu- 
meromerkkiä, mistä nimi kaksijärjestelmä johtuu. Binäärijärjestelmän numeroi- 
ta kutsutaan biteiksi (BIT = BInary digiT). Numeromerkkien vähyys johtuu sii- 
tä, että digitaalitekniikassa tunnetaan vain kaksi jännitetilaa, jotka yleensä ovat 
+5 volttia (vastaa lukua yksi) ja O volttia (vastaa nollaa). 

Ajatellaanpa kymmenjärjestelmän lukua 1988. Siinä ykkönen ilmoittaa tuhan- 
hannet, sadat, kymmenet ja ykköset lasketaan yhteen, saadaan luku 1988. Luku 
voidaan kirjoittaa kymmenen potenssien summana seuraavasti: 

1988 = 1*1073 + 9*1072 + 8*10/1 + 8*1070 
tuhannet sadat kymmenet ykköset 

Koska kyseessä on kymmenjärjestelmä, luvut esitetään nimenomaan kymme- 
nen potenssien avulla. Kaksijärjestelmässä taas käytetään kakkosen potensseja. 
Otetaan esimerkiksi kaksijärjestelmän luku %110101. Huomaa lukua edeltävä 
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%-merkki. Sitä käytetään jatkossa erottamaan binäärilukuja muiden lukujärjes- 
telmien luvuista. Kirjoitetaan nyt ylläoleva luku kakkosen potensseja käyttäen: 
%l110101 = 1*295+ 1*294 + 0*293 + 1202 + 0*21] + 1*200 
32:t 16:t 8:t 4:12:t I:t 

Nyt ensimmäinen numero (1) ei vastaakaan satoja tuhansia, vaan 32:ta. Seu- 
raava vastaa 16:tta ja viimeinen ykkösiä. Kun 32:t, 16:t, 8:t, neloset, kakkoset ja 
ykköset lasketaan yhteen, saadaan binääriluvun desimaalinen vastine. %110101 
on kymmenjärjestelmässä 32+16+4+1 = 53. Tässä kirjassa desimaalilukujen 
edessä ei ole mitään tunnusta. 

Kymmenjärjestelmän luvun muuntaminen binäärijärjestelmään tapahtuu vä- 
hentämällä muunnettavasta luvusta kakkosen potensseja suurimmasta alkaen. 
Jos jokin kakkosen potenssi pystyttiin vähentämään ilman, että tulos oli negatii- 
kua ei voitu suorittaa, binäärilukuun merkitään nolla. Esimerkiksi luku 198 
muunnetaan binääriluvuksi seuraavasti: 

Kokeillaan, voidaanko luvusta 198 vähentää 128. Koska tämä onnistuu, mer- 
kitään tulokseen ykkönen. Seuraavaksi vähennetään luvusta 70 64 (198-128 = 


tonen, josta ei voida vähentää 32:ta, 16:tta eikä 8:aa. Siksi tulokseen kirjoitetaan 
kolme nollaa. Nelosen ja kakkosen vähentäminen onnistuu, ykkösen ei, joten tu- 
lokseen merkitään vielä % 110. Binääriluvuksi saatiin % 11000110. Tulos tarkis- 
tetaan taskulaskimella. 
Binäärilukujen yhteen-, vähennys-, kerto- ja jakolaskut suoritetaan samaan ta- 
paan kuin desimaalilukujenkin. Lasketaan malliksi yhteen luvut %10101 ja 
% 1110011. Muistinumerot on merkitty yhteenlaskettavien yläpuolelle. 
11111 
10101 
+ 1110011 


10001000 
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Vähennyslasku tapahtuu vastaavasti. Esimerkkinä kertolaskusta kerrotaan 
keskenään luvut %10111 ja %101. 
10111 


00000 


110011 
Kuten huomataan, ykkösellä kerrottaessa kerrottava kopioituu sellaisenaan, 
nollalla kerrottaessa koko tulosrivi on nolla. Jakolasku sujuu myös täysin desi- 
maalijärjestelmän sääntöjen mukaisesti. 


Heksadesimaalijärjestelmä 


Koska binääriluvut venyvät helposti varsin mittaviksi, on jouduttu ottamaan 
käyttöön heksadesimaali- eli 16-järjestelmä. Siinä lukujen esittämiseen käyte- 
tään kymmenen numeron lisäksi myös kuutta kirjainta, yhteensä siis 16 merk- 
kiä. Tässä kirjassa heksadesimaalilukujen tunnuksena on käytetty luvun eteen 
kirjoitettua $-merkkiä. Oheisesta taulukosta selviää eri lukujärjestelmien vastaa- 
vuus. 

Muunnokset binääri- ja heksadesimaalijärjestelmien välillä ovat suhteellisen 
yksinkertaisia. Koska jokaista heksadesimaalimerkkiä vastaa neljä binääriluvun 
numeroa, voidaan lukuja käsitellä muunnoksen aikana neljän bitin ryhminä. Si- 
ten esimerkiksi $ffd2 on taulukon mukaisesti binäärinä %1111 1111 1101 0010. 
Vastaavasti % 11000110 = $c6. 


Oktaalijärjestelmä 


Tietokoneiden alkuaikoina käytettiin runsaasti oktaali- eli 8-järjestelmää. 
sä, on järjestelmä kuitenkin hyvä tuntea. Oktaaliluvun numeromerkit ovat taval- 
liset numerot nollasta seitsemään. Jokaista oktaaliluvun numeromerkkiä vastaa 
kolme binäärinumeroa eli bittiä. Siten muunnosten suorittaminen binääri- ja ok- 
taalijärjestelmien välillä on suhteellisen helppoa. Oktaaliluvun tunnuksena ohei- 
sessa taulukossa on käytetty & -merkkiä. 
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Taulukko: Lukujärjestelmämuunnokset 


desimaali — binääri heksadesimaali oktaali 
0 % 000000 $00 &000 
1 %000001 $01 &001 
2 %000010 $02 &002 
3 %000011 $03 &003 
4 %000100 $04 &004 
5 %000101 $05 &005 
6 %000110 $06 &006 
7 H000111 $07 &007 
8 %001000 $08 &010 
9 %001001 $09 &011 
10 %001010 $0a &012 
11 %001011 $0b &013 
12 %001100 $0c &014 
13 %001101 $0d &015 
14 %001110 $0e &016 
15 %001111 $Of &017 
16 %010000 $10 &020 
17 %010001 $11 &021 
18 %010010 $12 &022 


Kerätään bittejä 


Useimmin käytetyille binäärilukujen pituuksille on vakiintunut erityiset ni- 
met. 4-bittistä lukua sanotaan nybbleksi, 8-bittistä tavuksi, 16-bittistä sanaksi ja 
32-bittistä pitkäksi sanaksi. Englanninkieliset nimitykset on myös hyvä tuntea, 
sillä ne esiintyvät usein alan kirjallisuudessa. Nybble on tietysti englanniksi nyb- 
ble, tavu on byte, sana word ja pitkä sana long word. 


Onko muistissa paikka? 


Suurinta muistin osasta, jota prosessori voi kerralla käsitellä, kutsutaan muis- 
tipaikaksi. Koska Amigan keskusyksikössä MC68000:ssa on 16-bittinen data- 
väylä, on Amigan muisti 16 bittiä leveää ja jokainen muistipaikka sisältää 16 bit- 
tiä. Tavu on Amigassa vain muistipaikan puolikas. Koska osoitteet lasketaan 
kuitenkin 8-bittisten lukujen eli tavujen mukaan, muistipaikkojen osoitteet ovat 
aina parillisia (O, 2, 4, 6....). Kun prosessorilla siirretään tietoa parittomaan osoit- 
teeseen n, tieto siirtyykin muistipaikan n-1 toiseen puolikkaaseen. Tämän vuok- 
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Tavujen järjestys muistissa 


X Sana 
Osoite . 


= 
Pitkä 
nä 


si MC68000 voi siirtää parittomiin osoitteisiin ja niistä pois vain 8-bittistä tietoa. 

Jokaista muistipaikkaa vastaa siis oma osoitteensa, joka on Amigassa 24-bitti- 
nen binääriluku. Jos muistipaikan ajatellaan olevan muuttuja, voidaan sen osoi- 
tetta pitää muuttujan nimenä. 


Muuttujat 


Assembler- ja konekielisessä ohjelmoinnissa ei ole käytettävissä samanlaisia 
muuttujia kuin esimerkiksi Basicissa ja Pascalissa. Sen sijaan jokaista muisti- 
paikkaa tai niiden ryhmää voidaan pitää muuttujana. Assemblerkääntäjän avulla 
muistipaikoille voidaan antaa symbolisia nimiä, jotka selventävät muistipaikko- 
jen merkitystä muuttujanimien tapaan. 


Rekisteri 


Mikroprosessorin toiminnan ja assemblerohjelmoinnin kannalta rekistereillä 
on keskeinen merkitys. Rekisterit ovat prosessorin sisäisiä muistipaikkoja, joita 
se käyttää tiedon väliaikaiseen tallentamiseen. Kaikki loogiset ja matemaattiset 
toiminnat tapahtuvat yleensä prosessorin rekisterien välillä. Koska rekisterit si- 
jaitsevat prosessorin sisällä, on niiden käsittely huomattavasti nopeampaa kuin 
RAM-muistissa olevien muistipaikkojen. Siksi rekisterejä kannattaa pyrkiä hyö- 
dyntämään mahdollisimman paljon. Onneksi MC68000 sisältää peräti 15 käyttä- 
jän vapaasti käytettävää rekisteriä, joten monimutkaisiakin operaatioita voi to- 
teuttaa ilman muistin käyttöä. Seuraava luku esittelee yksityiskohtaisesti kaikki 
MC68000:n käyttäjälle näkyvät rekisterit. 
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Loogiset operaatiot 


Binääriluvuille muodostetaan usein myös loogisia operaatioita, joita ovat 
mm. JA, TAI, ETAI (Ehdoton TA1) ja EI. Säännöt ovat hyvin loogiset, kuten 
voi olettaa 

.0JA 0=0; OJA1=0; 1JA0=0; 1IJA1=1 

OTAI0=0; OTAI1=1; 1ITAI0=1; ITAI 1=1 

OETAI 0 =0; OETAI 1 = 1; 1 ETAI0=1;1 ETAI1=0 

EI0=1; EI 1=0 

MC68000-prosessori sisältää valmiit käskyt yhteen-, vähennys-, kerto- ja ja- 
kolaskuja sekä loogisia operaatioita varten, joten kaikkien operaatioiden muo- 
dostaminen on helppoa. 


Vieraskielinen sanasto 


Tässä kirjassa käytetään jonkin verran englanninkielisiä termejä siitä syystä, 
että niille ei ole olemassa vakiintunutta vastinetta suomen kielessä. Esimerkiksi 
sana structure merkitsee suomeksi rakennetta. Rakenne-sana ei kuitenkaan vas- 
taa structure-sanan merkitystä ohjelmointikielien yhteydessä. Englanninkielisten 
sanojen tunteminen helpottaa myös vieraskielisen Amiga-kirjallisuuden käyttöä 
Amigan assemblerohjelmoinnin opiskelussa. 
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Tietokoneen rakenne 


J tietokoneita ohjelmoivan on hyvä tietää jotakin niiden rakenteesta. 
Periaatteessa kaikissa tietokoneissa on erotettavissa samat perusosat: kes- 
kusyksikkö, muisti sekä syöttö- ja tulostuslaitteet. Seuraavassa tarkastellaan lä- 
hemmin Amigan rakennetta lohkokaavion avulla. 


Amigan sydän on MC68000-mikroprosessori. Se on yhteydessä käyttöjärjes- 
telmä-ROM-muistiin, liitäntäpiireihin CIAA ja CIAB sekä puskurin välityksellä 
CHIP RAM:iin ja apuprosessoreihin Agnus, Denise ja Paula. Lisäksi kuvasta nä- 
kyy mahdollisen laajennusmuistin (FAST RAM) sijoittuminen. Kuten lohkokaa- 
viosta huomataan, prosessorin ja ROM-muistien, laajennus-RAMin ja liitäntäpii- 
rien välillä on oma väylä ja apuprosessorien ja CHIP RAMin välillä oma. Väy- 
lät liittyvät toisiinsa puskurin avulla. Siksi prosessori pystyy toimimaan täydellä 
nopeudella omalla väylällään, vaikka apuprosessorit käyttävät omaa väyläänsä. 
MC68000:n väylällä olevaa lajennusmuistia kutsutaan tästä syystä nopeaksi 
RAM-muistiksi (FAST RAM). Tämän järjestelyn haittapuolena on, että apu- 
prosessorit eivät pysty lukemaan lainkaan laajennusmuistissa olevaa tietoa, ellei 
MC68000 ensin siirrä sitä CHIP RAM -alueelle. 

Todellisuudessa CHIP RAM on kytketty MC68000-prosessoriin Agnus-apu- 
prosessorin välityksellä. Agnus nimittäin huolehtii dynaamisten RAM-muistien 
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tarvitsemista virkistysjaksoista ja osoitteiden multipleksoimisesta. Amiga 500:n 
512 kilotavun lisämuisti liittyy myös järjestelmään Agnuksen kautta, joten se ei 
ole "oikeaa" FAST RAM -muistia. 

Liitäntäpiirit CIAA ja CIAB huolehtivat mm. näppäimistön ja centronics-por- 
tin toiminnoista ja levyasemien ohjauslinjoista. Lisäksi ne sisältävät järjestel- 
män ajastinlaskurit. Apuprosessorit taas huolehtivat mm. kuvan ja äänen muo- 
dostuksesta, animaatiosta, RS-232-portista ja hiirten hallinnasta. 

Koska suuri osa perustoiminnoista on siirretty keskusyksiköltä apuprosesso- 
reille, jää suurempi osa keskusyksikön tehosta varsinaisen ohjelman suorittami- 
seen. Valitettavasti kaikki ohjelmat eivät hyödynnä täysin Amigan apuprosesso- 
reita. Esimerkiksi useat pelit ovat lähes suoria kopioita muista koneista eivätkä 
siksi käytä grafiikan ja animaation tuottamiseen Amigan tehokasta blitteriä, joka 
kuuluu osana apuprosessorien muodostamaan kokonaisuuteen. Blitter pystyy esi- 
merkiksi piirtämään viivoja miljoonan pikselin sekuntinopeudella. 


Keskeytys 


Keskeytykset ovat varsin tärkeä osa tietokoneen toimintaa. Keskeytysten 
avulla mikroprosessori saa tietoa ulkopuolisista tapahtumista ilman, että sen tar- 
vitsee tarkkailla niitä jatkuvasti. 

Keskeytysten puuttuminen vastaa puhelinta, jossa ei ole soittokelloa. Saadak- 
seen selville yrittääkö joku soittaa, olisi puhelimen käyttäjän nostettava kuuloke 
useita kertoja minuutissa läpi vuorokauden. Ilman keskeytyksiä mikroprosessori 
joutuisi tarkkailemaan useita asioita jopa tuhansia kertoja sekunnissa, mikä ku- 
luttaisi melkoisen osan sen tehosta aivan turhaan. 

Kun prosessori saa keskeytyksen, se tallentaa pinomuistiin tiedot ohjelmasta, 
jota se juuri oli suorittamassa ja siirtyy erityiseen keskeytysrutiiniin. Tässä ru- 
tiinissa prosessori käsittelee keskeytyksestä riippuen erilaisia tietoja ja jatkaa sit- 
ten ohjelmaa, jota se oli suorittamassa keskeytyksen saapuessa. Tilanne vastaa 
puhelimen soimista kesken Aku Ankan lukemisen. Puhelimen sointi keskeyttää 
lukemisen, jota jatketaan jälleen puhelinkeskustelun päätyttyä. 

MC68000 ymmärtää seitsemän eri keskeytystä, joilla jokaisella on oma priori- 
teettinsä eli tärkeysjärjestyksensä. Keskeytykset on numeroitu ykkösestä seitse- 
mään. Mitä suurempi numero, sitä tärkeämpi keskeytys. Jos keskeytysrutiinin 
suorituksen aikana sattuu toinen keskeytys, prosessori huomioi sen välittömästi 
vain, jos uuden keskeytyksen prioriteetti on korkeampi kuin entisen. Muussa ta- 
pauksessa prosessori suorittaa ensin loppuun entisen keskeytystrutiinin ja aloit- 
taa vasta sitten uuden palvelemisen. 

Eri arvoisia keskeytyksiä voidaan verrata tilanteeseen, jossa puhelin soi kes- 
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ken Aku Ankan lukemisen. Kesken puhelun taas soi ovikello. Koska ovikello- 
keskeytyksen prioriteetti on korkeampi kuin puhelimen, puhelinkeskustelu kes- 
keytetään siksi aikaa, että tarkistetaan, kuka ovella on. Sitten palataan puheli- 
meen ja aikanaan edelleen Aku Ankan lukemiseen. 

Amigassa keskeytyksillä on keskeinen merkitys. Niiden avulla luetaan näp- 
päimistöä, valvotaan hiirten liikkeitä, hoidetaan lev yasemien toimintaa, ohjataan 
tarvittaessa äänen tuottoa ja huolehditaan siitä, että jokainen käynnissä oleva oh- 
jelma saa käyttää prosessoria vuorollaan. 


Pinomuisti 


Aliohjelmakutsujen ja keskeytysten kannalta välttämätön tekijä on pinomuis- 
ti. Pinomuisti on osa tavallisesta RAM-muistista, joka on varattu erityisesti tä- 
hän käyttöön. Pinomuistia osoitetaan pino-osoittimen avulla ja sitä käytetään tal- 
lennettaessa aliohjelmien paluuosoitteita, prosessorin rekisterejä jne. Pinomuisti 
on toiminnaltaan LIFO-tyyppinen (Last In First Out) eli sinne viimeksi tallennet- 
tu tieto tulee ensimmäisenä pois. 

Pinomuistia voidaan verrata vaikkapa paperipinkkaan. Vain pinkan päälle 
voidaan lisätä papereita ja vain päällimmäinen paperi voidaan poistaa pinkasta. 

Kun prosessori tallentaa pinomuistiin luvun, pino-osoitinta pienennetään en- 
sin (pinomuisti siis kasvaa muistissa alaspäin eli suuremmasta osoitteesta pie- 
nempään päin). Vasta sitten haluttu luku siirretään pino-osoittimen osoittamaan 
paikkaan. Kun pinosta otetaan lukuja, luvun lukeminen tapahtuu ensin, minkä 
jälkeen kasvatetaan pino-osoitinta. 

Pinomuistin toimintaa havainnollistaa myös seuraavalla sivulla oleva kuva, 
joka esittää ohjelmaa ja siihen liittyvää aliohjelmaa. Aluksi pinossa on vain pää- 
ohjelman paluuosoite. Pinomuistia esittävän kuvan vieressä ovat kuvitteelliset 
muistiosoitteet, joista nähdään pinon kasvaminen suuremmasta osoitteesta pie- 
nempään päin. 

Ohjelman ensimmäinen käsky tallentaa datarekisterin DO sisällön pinomuis- 
tiin. Sitten DO:aan siirretään luku 205178 ja kutsutaan aliohjelmaa, jonka paluu- 
taa pino-osoitinta. 

Aliohjelma tallentaa DO:n arvon pinoon, suorittaa pari operaatiota ja ottaa 
D0:n pinosta sekä palaa pääohjelmaan. Pääohjelma ottaa pinosta D0:n ja palaa 
edelleen sitä kutsuneeseen rutiiniin. Pinon kuvassa näkyvä alue on nyt tyhjenty- 
nyt. 

Esimerkkiohjelman toiminnassa ei ole mitään järkeä, se on mukana vain pi- 
noesimerkkinä. Kannattaa myös pitää mielessä, ettei pinon sisältö katoa minne- 
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kään kun pinosta otetaan tietoa. Tiedot ovat edelleen tallella entisissä osoitteis- 
saan kunnes jokin uusi tieto kirjoitetaan samaan paikkaan. Prosessorin kannalta 
pino-osoittimen ilmaiseman osoitteen alapuolinen osa pinosta kuitenkin on "tyh- 


MOVE.L W205178,D0 
BSR Subr 
MOVEN.L (SP)+,D8 


RIS 
Subr: MOVEM.L D8,-(SP) 


MOVE.L D0,Regi 
ADDO.L %1,08 

MOVE.L D0,Reg2 
NA (SP)+,D0 


Main: MOVEM.L D6,-(SP) 


MOVE.L 1205178,D0 
BSR Subr 
MOVEN .L (SP)+,D6 
RTS 


MOVE.L D8,Regi 
ADDO.L %1,D8 
MOVE.L D6,Reg2 


Main: MOYEM.L D8,-(SP) 
MOVE L 8205178,D0 


MOVEM.L (SP)+,D8 
TS 


R 

Subr : MOVEM.L D8,-(SP) 
MOVE.L DO,Regi 
ADDO.L 1,00 
MOVE.L D0,Reg2 
MOVEM.L (SP)+,D0 
RTS 


Main: MOVEM.L D6,-(SP) 
MOVE.L W205178,D8 
BSR Subr 
MOVEM.L (SP)+,D0 


RTS 

Subr : MOVEM.L D8,-(SP) 
NOVE.L D0,Regi 
ADDO.L 81,00 
MOVE.L D6,Reg2 


uuosoite 


MOVEM.L (SP)+,D0 MOVEM,L (SP)+,D6 
RTS 


Main: MOVEM.L D8,-(SP) Main:MOVEM.L D6,-(SP) 


MOVE.L 1205178,D0 
BSR Subr 
MOVEM.L (SP)+,D8 
RIS 

1 MOVEM .L D8,-(SP) 


Main: MOVEM.L D8,-CSP) 
MOVELL W205178,D6 
BSR Subr 
MOVEM L (SP)+,D8 


MOVEM.L D6,-(SP) 


MOVEM.L (SP)+,D8 
RIS 


MOVELL $205178,D0 
BSR Subr 


HOVEM.L (SP)+,D9 


RTS 

Subr : MOVEM.L D6,-(SP) 
MOVE.L D8,Regi 
ADDO.L 1,00 
MOVE.L D0,Reg2 
MOVEM.L (SP)+,D0 
RTS 


ma 
kum 
essa! 
LE— 
===] 
[<=-ja 
——ja 
[Faiuosonejä 
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Sukellus 
keskusyksikön 
salaisuuksiin 


K" Amigaa alettiin suunnitella, haluttiin koneeseen valita tehokas ja edulli- 
nen mikroprosessori. Oli myös tärkeää, että prosessori oli yleisessä käytös- 
sä, jolloin sen saanti olisi turvattua myös tulevaisuudessa. Siksi valittiin Motoro- 
lan MC68000, tehokas 16/32-bittinen mikroprosessori, jonka eduksi voidaan las- 


käskykannan ja tehokkaiden osoitusmuotojen ansiosta. 


MC68000:n sielunelämää 


MC68000 on sisäisesti 32-bittinen, ulkoisesti 16-bittinen. Käytännössä tämä 
tarkoittaa sitä, että MC68000:n rekisterit ovat 32-bittisiä ja dataväylä 16-bitti- 
nen. Osoiteväylä puolestaan on 24-bittinen eli muistiavaruus on 16 megatavua 
(16777216 tavua). 

16-bittisen dataväylän ansiosta MC68000 pystyy siirtämään itsensä ja muistin 
välillä 8- tai 16-bittisiä lukuja yhdellä muistiosoituksella. Sen sijaan koko 32 bi- 
tin rekisterin siirtämistä varten prosessori joutuu osoittamaan muistia kaksi ker- 
taa. Käskyt kuitenkin tukevat myös 32 bitin luku- ja kirjoitustoimintoja, eikä oh- 
jelmoijan tarvitse välittää siitä, että dataväylä on vain 16 bittiä leveä. 


Rekisterivalikoima 


MC68000 sisältää oheisen kuvan mukaisesti 18 32-bittistä rekisteriä ja 16-bit- 
tisen status-rekisterin. Yksi 32-bittisistä on ohjelmalaskuri, kaksi pino-osoitinta, 
loput 15 rekisteriä ovat käyttäjän mielivaltaisessa käytössä. Kuvassa tummenne- 
tulla pohjalla olevat A7" ja Statuksen ylempi puolikas ovat käyttäjälle näkymät- 
tömissä, sillä niitä voi osoittaa vain prosessorin ollessa ns. Supervisor-tilassa 
(käytännössä vain keskeytysten aikana). 

Käyttäjän kannalta tärkeimmät ovat kuvassa ylimpinä näkyvät datarekisterit 
D0...D7, jotka vastaavat useissa mikroprosessoreissa olevaa akkua. Datarekiste- 
rejä käsittelevät käskyt ovat erittäin monipuolisia. 
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31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 HI 9 BTES43I2I 8 


A6 
E I H SEEN KEN 


ä A? / SSP 
15 4132110898 7651432108 
EäTSstes] | | [x]n]z]vicjsr & ccr 

Vain Supervisor-tilassa 


Toinen rekisteriryhmä on osoiterekisterit AO...A7, joiden avulla voidaan mm. 
osoittaa muistia. Näistä A7 toimii pino-osoittimena, joten käyttäjälle jäävät re- 
kisterit AO...A6. Kuten jo aiemmin mainittiin, A7" on käyttöjärjestelmän pino- 
osoitin ja käyttäjälle näkymättömissä. Käyttäjän pino-osoitin on A7. 

Status-rekisteri muodostuu kahdesta osasta: tilakoodeista ja systeemitavusta. 
Tilakoodeihin kuuluu viisi lippua, jotka ilmaisevat viimeisen toiminnon tulok- 
sen ominaisuuksia. 


Datarekisterit (D0...D7) 


Kaikki kahdeksan datarekisteriä D0...D7 ovat samanarvoisia. Kaikissa toimin- 
noissa, joissa niitä käytetään, voidaan vapaasti valita käytettävä(t) rekisteri(t). 
Useissa muissa prosessoreissa on esimerkiksi kertolasku rajoitettu johonkin tiet- 
tyyn rekisteriin. 
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Koska rekisterit ovat kaikki 32-bittisiä, on suurtenkin kokonaislukujen käsitte- 
ly erittäin helppoa. Koko rekisteri voidaan ladata tai tallentaa muistiin yhdellä 
käskyllä. 

Datarekistereissä voidaan käsitellä tietoa biteittäin, tavuittain (8 bittiä), sanoit- 
tain (16 bittiä) tai pitkinä sanoina (kaksi sanaa eli 32 bittiä). 

Käsiteltäessä tietoa esimerkiksi tavuina ylimmät 24 bittiä datarekisteristä säi- 
lyvät muuttumattomina. Tällöin esimerkiksi N-lippu (ilmaisee, että luku on ne- 
gatiivinen) asettuu, jos tavun ylin bitti eli bitti 7 on ykkönen. Sanoja käsiteltäes- 
sä N-lipun tila riippuu bitistä 15 (sanan ylin bitti) ja pitkiä sanoja käsiteltäessä 
bitistä 31. 

Tavuja käsiteltäessä käytössä ovat datarekisterin bitit 0...7, sanoissa bitit 
0...15. Pitkät sanat täyttävät bitit 0...31. 


Osoiterekisterit (A0...A7) 


Kaikki osoiterekisterit lukuunottamatta A7:ää ovat samanarvoisia. Niitä käy- 
tetään esimerkiksi taulukoihin ja puskureihin viitattaessa. 

Osoiterekisterejä koskevat operaatiot ovat aina joko 16- tai 32- bittisiä. Kun 
osoiterekisteriin siirretään jokin arvo (yleensä osoite), se laajennetaan aina koko 
rekisterin kokoiseksi eli 32- bittiseksi. Mikäli siirretty luku oli negatiivinen, 
myös lopullinen arvo on negatiivinen. Siten esimerkiksi luku $8e78 siirrettynä 
osoiterekisteriin 16-bittisenä asettaa osoiterekisterin arvoksi $ffff8e78 (luku tul- 
kitaan negatiiviseksi, koska sen ylin bitti on ykkönen). 

Vaikka osoiterekisterit ovatkin 32-bittisiä, MC68000 ei pysty hyödyntämään 
ylimpiä 8 bittiä, koska sen ulkoinen osoiteväylä on vain 24-bittinen. Sen sijaan 
esimerkiksi MC68000:n isoveli MC68020 käyttää 32-bittistä ulkoista osoite- 
väylää. 

AT toimii pino-osoittimena. Pinoon tallennetaan esimerkiksi aliohjelmakutsu- 
jen yhteydessä paluuosoite. MC68000-sarjan prosessoreissa on erillinen käyttä- 
jän tila ja ns. Supervisor-tila. Siten A7 sisältää tavallisesti käyttäjän pino-osoitti- 
men ja Supervisor-tilassa systeemin pino-osoittimen. Tästä ei kuitenkaan tarvit- 
se välittää, sillä Amigassa MC68000 toimii Supervisor-tilassa vain käyttöjärjes- 
telmän rutiinien aikana. Käyttäjälle Supervisor-tila ei siis "näy" mitenkään. 


Ohjelmalaskuri (PC) 

Ohjelmalaskuri on, kuten jo mainittiin, 32-bittinen. Sitä kuitenkin koskevat 
samat rajoitukset kuin osoiterekisterejäkin eli ylimpiä kahdeksaa bittiä ei 
MC68000:ssa voi käyttää ulkoisen osoiteväylän suppeuden vuoksi. 
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Status-rekisteri (SR, CCR) 


Status-rekisteri muodostuu siis kahdesta tavusta. Alempi tavu sisältää tilakoo- 
dit eli viisi bittiä, joita kutsutaan lipuiksi. Liput ovat Extend X (tilarekisterin bit- 
ti 4), Negative N (bitti 3), Zero Z (bitti 2), Overflow V (bitti 1) ja Carry C (bitti 
0). 

Statuksen tavua, joka sisältää tilakoodit, kutsutaan jäljempänä tilarekisteriksi, 
jonka lyhenne on CCR (Condition Code Register). Tilarekisterin lippujen avulla 
muodostetaan mm. ehdolliset haarautumiset ja pidetään huolta yhteenlaskun 
muistinumeroista. 

Statuksen ylempi tavu sisältää käyttöjärjestelmälle tarpeellisia bittejä, joihin 
pääsy on käyttäjältä estetty. Tähän ns. systeemitavuun sisältyvät keskeytyksen 
tason ilmaisevat bitit 12, 11 ja IO (statuksen bitit 10, 9 ja 8), Supervisor-lippu S 
(bitti 13) ja Trace-lippu T (bitti 15). 

Status-rekisteri-nimitys siis käsittää tilarekisterin ja systeemitavun, tilarekiste- 
ri vain statuksen alemman tavun. 

Status-rekisterin lippujen merkitykset ovat seuraavat: 

Carry C 

C sisältää viimeisimmän operaation eniten merkitsevän bitin, kuten yhteenlas- 
kussa muistinumeron. Vähennyslaskussa C=1 ilmaisee, että vähenevä oli pie- 
nempi kuin vähentäjä. 

Overflow V 

eli ylivuoto V asettuu, jos operaation tulos oli suurempi, kuin mitä kohdepara- 
metrin ja C-lipun avulla voidaan esittää. Esimerkiksi jakolaskukäsky voi asettaa 
V-lipun. 

Zero Z 

Z asettuu, jos operaation tulos on nolla tai kun vertailtavat luvut ovat yhtäsuu- 
ret. Tavuja käsiteltäessä esimerkiksi datarekisterin 24 ylintä bittiä eivät vaikuta 
Z-lipun tilaan. 

Negative N 

N asettuu, jos tulos on negatiivinen eli jos tuloksen ylin bitti on ykkönen. Kä- 
siteltävän tiedon koosta riippuen tuloksen ylin bitti on bitti 7, 15 tai 31. 

Extend X 

X asettuu yleensä samaan tilaan kuin C. Joidenkin käskyjen yhteydessä X säi- 
lyy ennallaan, vaikka C muuttuu. 

Supervisor S 

Kun S-lippu on ykkönen, prosessori toimii Supervisor-tilassa. Tällöin kaikki 
sen käskykannan käskyt ovat käytettävissä ja pino-osoittimena käytetään systee- 
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Supervisor-tilassa käyttöjärjestelmän rutiinien ja esimerkiksi keskeytysten aika- 
na. Käyttäjän ohjelmaa ajettaessa prosessori on normaalitilassa. 

Supervisor-tilaa voitaisiin hyödyntää moniajokoneessa, jossa käytetään 
MMU- eli muistinhallintayksikköä. Sen avulla voitaisiin estää käyttäjän ohjel- 
maa käsittelemästä järjestelmän sisäisiä tai muille ohjelmille kuuluvia muistialu- 
eita. Amigassa ei MMU-piiriä kuitenkaan ole ja siksi Supervisor-tilalla on vä- 
hemmän merkitystä. 

Trace T 

Jos T-lippu on ykkönen, prosessori toimii tilassa, jossa se suorittaa yhden käs- 
kyn kerrallaan ja siirtyy sen jälkeen Supervisor-tilaan. Tätä ominaisuutta käyte- 
tään hyväksi joissakin monitori- ja debuggausohjelmissa etsittäessä ohjelmista 
virheitä. Prosessorin annetaan suorittaa tutkittavaa ohjelmaa käsky kerrallaan. 
Käskyjen välillä tulostetaan prosessorin rekisterien arvot, jolloin toimintaa on 
helppo seurata. 

Interrupt Priority 12, 11, 10 

MC68000 pystyy toimimaan kahdeksalla eri tasolla, prioriteetilla. Kun pro- 
sessori suorittaa normaalia ohjelmaa, taso on nolla. Jokaisella keskeytyksellä on 
oma tasonsa, joiden numerot ovat 1...7. Kun prosessori saa keskeytyksen, jonka 
taso on suurempi kuin sen hetkinen prioriteetti, se siirtyy suorittamaan uutta kes- 
keytystä. Jos prosessorin prioriteetti oli korkeampi kuin saapuneen keskeytyk- 
sen, keskeytystä ei palvella (eli vastaavaa rutiinia ei suoriteta) ennen kuin pro- 
sessorin prioriteetti on laskenut riittävän alhaiselle tasolle. Eri prioriteettien avul- 
la voidaan erilaisille tapahtumille antaa oma tärkeysjärjestyksensä. Jotkut asiat 
vaativat välittömästi prosessorin huomiota, joten niille annetaan korkea priori- 
teetti, esimerkiksi kuusi. Toisten asioiden huomioimisella taas ei ole erityisem- 
pää kiirettä, joten niille voidaan antaa esimerkiksi prioriteetti 2. Tavallisesti 
Amigan ohjelmoijan ei tarvitse välittää I-biteistä. Keskeytysten prioriteetit on 


Pino-osoittimet 


MC68000 sisältää siis kaksi pino-osoitinta, toisen käyttäjän tilaa ja toisen Su- 
pervisor-tilaa varten. Käyttäjän tilassa päästään käsiksi vain käyttäjän pino-osoit- 
timeen, Supervisor-tilassa voidaan osoittaa molempia. Osoiterekisteri A7 sisäl- 
tää aina käytössä olevan pino-osoittimen arvon ja se myös toimii pino-osoittime- 
na. Supervisor-tilassa pino-osoittimia kutsutaan lyhenteillä USP (käyttäjän pino- 
osoitin = User Stack Pointer) ja SSP (Supervisor Stack Pointer). Koska kaikki 
ohjelmat toimivat tavallisesti prosessorin normaalitilassa, SSP:llä on varsin vä- 
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hän merkitystä aloittelevalle ohjelmoijalle. 

Esimerkiksi Metacomcon makroassembleri ymmärtää merkinnän sp, joka tar- 
koittaa pino-osoitinta. Tämä merkintä on havainnollisempi kuin pelkkä A7 pino- 
osoitinta käytettäessä. 

Normaalin käytännön mukaisesti myös MC68000:n pino kasvaa alaspäin. Si- 
tä havainnollistaa esimerkiksi rekisterin DO pinoon tallentaminen: 

MOVE.ZL D0,-(A7) 
ka kyseessä pitkä sana DO.L) ja siirretään sitten DO:n arvo pino-osoittimen il- 
maisemaan paikkaan. Vastaavasti DO:n ottaminen pinosta lukee ensin rekisterin 
DO arvon ja kasvattaa vasta sitten pino-osoitinta: 

MOVEZL (A7)+,D0 

Pino-osoitin ilmaisee suoraan pinoon viimeksi tallennetun luvun osoitteen. Pi- 
no-osoittimen arvon on aina pysyttävä parillisena eli sen on aina osoitettava sa- 
naa, koska MC68000 ei pysty noutamaan sanoja eikä pitkiä sanoja parittomista 
osoitteista. Tästä syystä A7 käyttäytyy muista osoiterekistereistä poikkeavasti: 
Jos pinoon tallennetaan tavu, pino-osoitinta pienennetään silti kakkosella ykkö- 
sen sijasta. Pinosta varataan siten kaksi tavua yhden tavun tallentamista varten. 
Onkin suositeltavaa tallentaa pinoon aina vain 16- tai 32-bittisiä lukuja, jolloin 
pino-osoitin pysyy varmasti parillisena. 


Tietopalleroiden siirtäminen 


MC68000 pystyy käsittelemään tietoa bitteinä, tavuina, sanoina tai pitkinä sa- 
noina. Siksi useimmista käskyistä on olemassa kolme eri muotoa, jotka erote- 
taan toisistaan käskyn nimen perään kirjoitettavan kirjaimen perusteella. Esimer- 
kiksi MOVE. B käsittelee 8 bitin (Byte), MOVE.W 16 bitin (Word) ja MOVEL 
32 bitin (Long) lukuja. 

Useampitavuiset luvut (sanat ja pitkät sanat) sijoittuvat muistiin siten, että pie- 
nimmässä osoitteessa on luvun eniten merkitsevä ja suurimmassa osoitteessa vä- 
hiten merkitsevä tavu. Tämä vastaa meille tuttua lukujen kirjoitustapaa. Esimer- 
kiksi heksadesimaaliluku $12345678 sijoittuu muistiin järjestyksessä $12, $34, 
$56, $78. Tämä on päinvastoin kuin esimerkiksi 6502-sarjan prosessoreissa. 
Syyn tällaiseen tavujen järjestykseen aiheuttaa se, että MC68000 pystyy osoitta- 
maan muistia 8-, 16- tai 32-bittisenä. 

Koska MC68000:n dataväylä on 16-bittinen, se aiheuttaa tiettyjä rajoituksia 
tiedon käsittelyyn. Kuten 8-bittisissä koneissakin, tietotavu voi sijaita muistissa 
joko parillisessa tai parittomassa osoitteessa. MC68000:ssa pariton osoite onkin 
itse asiassa vain 16-bittisen sanan puolikas; vastaava parillinen osoite on sanan 
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ensimmäinen puolikas. Tästä johtuu, että 16- ja 32-bittisen tiedon on sijaittava 
parillisissa osoitteissa, jotta prosessori pystyisi niitä käsittelemään. Samoin itse 
käskyjen on aina sijaittava parillisesta osoitteesta alkaen. 

Tarkastellaan ongelmaa esimerkin avulla. Oletetaan, että tietty sana alkaa 
osoitteesta 3. Silloin sen ylempi tavu sijaitsee edellisen mukaan osoitteessa 3 ja 
alempi osoitteessa 4. Koska Amigan muisti on 16-bittistä, tavut O ja 1 sijaitsevat 
samassa sanassa, tavut 2 ja 3 samassa jne. Jos prosessori nyt haluaisi lukea osoit- 
teesta 3 alkavan sanan, se joutuisi lukemaan sanan tavut eri muistisanoista. Ta- 
vallaan tilanne vastaa sitä, että 8-bittinen prosessori yrittää lukea tavun puolik- 
kaat eri muistipaikoista. Koska prosessori voi kuitenkin osoittaa vain yhtä osoi- 
tetta kerrallaan, tämä on mahdotonta. Tärkeintä on muistaa, että käskyjen, sano- 
jen ja pitkien sanojen on AINA sijaittava parillisissa osoitteissa, muuten Amiga 
antaa gurun numero kolme (Address Error). 


Osoitusmuodot 


Seuraavan aukeaman kuvan mukaisesti MC68000:ssa on 12 varsinaista osoi- 
tusmuotoa implied-muodon eli parametrittoman osoituksen lisäksi. Ne esitellään 
seuraavassa yksitellen ja jokaisen käytöstä annetaan esimerkki. 

Operanditon osoitus (Implied Addressing) 

Yksinkertaisin osoitusmuodoista on operanditon osoitus. Siihen ei kuulu käs- 
kyn lisäksi yhtään operandia. Hyvä esimerkki tällaisesta käskystä on NOP (No 
OPeration), joka nimensä mukaisesti ei tee mitään. 

Syntaksi: NOP ; ei tee mitään 

Rekisteriosoitus (Register Direct Addressing) 

Rekisteriosoituksessa käsky käsittelee osoite- tai datarekisterin arvoa. Rekis- 
teri ilmoitetaan käskyn jäljessä. Esimerkiksi MOVE.L D0,D1 siirtää datarekiste- 
rin DO arvon 32- bittisenä datarekisteri D1:een. Tässä osoitusmuodossa toimin- 
nan kohteena on siis prosessorin rekisterin arvo. 

Syntaksi: CLR.L DO ; nollaa rekisterin DO 

Välitön osoitus (Immediate Addressing) 

Välittömässä osoituksessa käsky käsittelee välittömästi käskyä seuraavaa lu- 
kua, esimerkiksi siirtäen sen datarekisteriin. Käsky MOVE.W H1234,DO siirtää 
datarekisteri DO:aan luvun 1234. Välittömän osoituksen merkkinä käskyssä on 
$. On tärkeää erottaa toisistaan välitön osoitus, joka siirtää jonkin luvun rekiste- 
riin, ja absoluuttinen osoitus, joka siirtää muistipaikan sisällön rekisteriin. Välit- 
tömän osoituksen erikoistapauksena ovat ns. guick-käskyt (MOVEO, ADDO, 
SUBO), joissa välitön luku sisältyy itse käskyyn sen sijaan, että se olisi muistis- 
sa käskyä seuraavissa tavuissa. 
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Syntaksi: MOVE L45,.DO ; siirtää DO:aan luvun 5 

Absoluuttinen osoitus (Absolute Addressing) 

Absoluuttisessa osoituksessa käskyä seuraava luku ilmaisee muistipaikan, 
jonka arvo on käskyn kohteena. Esimerkiksi MOVE.B 100000,D0 siirtää muisti- 
paikan 100000 arvon DO:aan (EI siis siirrä lukua 100000 DO:aan!). Absoluutti- 
sesta osoituksesta on olemassa kaksi eri muotoa, xxx.L ja xxx. W. Näistä ensim- 
mäiseen kuuluu 32-bittinen osoite eli kohdemuistipaikka voi olla missä tahansa 
muistiavaruudessa. Jälkimmäiseen kuuluu vain 16-bittinen osoite, joka tulkitaan 
etumerkillisenä. Siksi sitä käyttäen voidaan osoittaa vain muistipaikkoja - 
32768...32767. Koska Amigassa ei ole kiinteitä muistipaikkoja esimerkiksi käyt- 
töjärjestelmää varten, ei tällä ole suurtakaan merkitystä. 

Syntaksi: MOVE.W D0,654321 ; siirtää DO:n arvon 

; muistipaikkaan 654321 

Suhteellinen osoitus 

Suhteellinen osoitusmuoto on käytettävissä vain lähdeparametrille. Kohdepa- 
rametriä voidaan osoittaa esimerkiksi epäsuoralla osoitusmuodolla, ellei abso- 
luuttista osoitusta haluta käyttää. 

Program Counter Relative Addressing 

Tässä osoitusmuodossa käskyyn kuuluu 16-bittinen etumerkillinen luku, joka 
lisätään ohjelmalaskurin arvoon. Näin saadaan käskyn kohdeosoite. Jos ohjel- 
massa tarvitaan tietojen tallentamista varten muistipaikkoja, niitä kannattaa 
osoittaa suhteellisella osoitusmuodolla, koska se vie vain yhden sanan muistia 
osoitetta kohti, on nopeampi ja mahdollistaa ohjelman lataamisen mielivaltai- 
seen kohtaan muistissa. Esimerkiksi MOVE.L LUKU (pc),DO ottaa 32-bittisen 
luvun muistipaikasta LUKU rekisteriin DO. LUKU-muistipaikan on sijaittava al- 
le 32 kilotavun päässä käskystä (siis samassa ohjelmassa). 

Syntaksi: MOVE.B TAVU(pe),DS — ; siirtää DS:een tavun 

; osoitteesta TAVU (osoite 
; suhteellinen 
; ohjelmalaskuriin) 

Relative with Offset 

Tässä osoitusmuodossa käskyn kohdeosoite saadaan lisäämällä käskyyn kuu- 
luva 16-bittinen etumerkillinen offset-arvo ohjelmalaskurin arvoon, kuten a)- 
kohdassakin. Lisäksi äskeiseen summaan lisätään vielä indeksirekisterin (jokin 
data- tai osoiterekisteri) arvo. Esimerkiksi MOVE.L TAULUKKO(pc,D1),D0 
ottaa DO:n arvon osoitteesta, joka saadaan laskemalla yhteen ohjelmalaskurin, 
DI:n ja TAULUKKO-lapun arvot. 

Jos indeksirekisteriin liitetään määrite .L, sen kaikki 32 bittiä otetaan huomi- 
oon käskyn kohdeosoitetta laskettaessa. Jos määrite on W tai jos sitä ei ole, 
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vain alimmat 16 bittiä huomioidaan. Indeksirekisterin arvo tulkitaan etumerkil- 
lisenä. 

Syntaksi: MOVE.L TA(pc,D4),D0 ; siirtää DO:aan pitkän sanan 

; osoitteesta TA + 
; ohjelmalaskuri + D4 

Epäsuora osoitus (Register Indirect Addressing) 

Epäsuorassa osoituksessa osoiterekisteri sisältää käskyn varsinaisen kohteen 
osoitteen. Siis esimerkiksi MOVE.B (A0),D0 siirtää DO:aan luvun muistipaikas- 
ta, jonka osoite on AO:ssa. Epäsuorasta osoituksesta on useita eri tyyppejä, jotka 
esitellään seuraavassa. 

Register indirect 

Tässä osoitusmuodossa osoiterekisteri ilmaisee käskyn kohdeosoitteen. 

Syntaksi: MOVE.B (A0)(A1 ) ; siirtää tavun AO:n 

; ilmaisemasta A 1:n ilmaisemaan 
; paikkaan. 

Postincrement Register Indirect 

Tämä on muuten sama kuin Register Indirect, mutta operaation jälkeen osoite- 
rekisterin arvoa kasvatetaan yhdellä (tavuosoitus), kahdella (sanaosoitus) tai nel- 
jällä (pitkä sanaosoitus). 

Tämä osoitusmuoto on erityisen käyttökelpoinen siirrettäessä tietoa muistissa 
paikasta toiseen, koska osoite kasvaa automaattisesti. 

Syntaksi: MOVE.W (A0)+((A 1)+; siirtää sanan A0:n 
; ilmaisemasta A 1:n ilmaisemaan 
; paikkaan, lopuksi A0O:aan ja 
a : A1:een lisätään kaksi. 

Predecrement Register Indirect 

Muuten sama kuin Register Indirect, mutta ennen operaatiota osoiterekisterin 
arvoa pienennetään yhdellä (tavuosoitus), kahdella (sanaosoitus) tai neljällä (pit- 
kä sanaosoitus). 

Tätäkin osoitusmuotoa voi käyttää muistialueiden siirrossa, koska osoite pie- 
nenee automaattisesti ilman erillisiä käskyjä. 

Syntaksi: MOVE.ZB -(A3),-(A4) ; vähentää A3:sta ja A4:stä 

; ykkösen ja siirtää tavun A3:n 
; osoittamasta paikasta A4:n 
; osoittamaan paikkaan. 

Register Indirect with Offset 

Muuten sama kuin Register Indirect, mutta osoiterekisteriin lisätään eräänlai- 
nen välitön luku, offset. Käskyn kohdeosoite saadaan yksinkertaisesti laskemal- 
la yhteen tämä 16-bittinen etumerkillinen offset-arvo ja käytetyn osoiterekiste- 
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rin arvo. 

Tätä osoitusmuotoa käytettäessä esimerkiksi A4 voisi sisältää I/O-piirien al- 
kuosoitteen ja erilaisten offset-arvojen avulla voitaisiin A4:ää muuttamatta pääs- 
tä käsiksi eri I/O- rekistereihin. 

Tämän osoitusmuodon etuna absoluuttiseen verrattuna on pienempi muistin- 
kulutus (offset vie vain yhden sanan absoluuttisen osoitteen kahden sijasta) ja 
suurempi nopeus (muistista tarvitaan noutaa vain yksi sana). 

Syntaksi: MOVE.W 14,$180(a4) ; kirjoittaa luvun neljä 

; muistipaikkaan, jonka osoite 
; saadaan laskemalla yhteen 
; A4:n arvo ja heksaluku $180. 

Indexed Register Indirect with Offset 

Tässä osoitusmuodossa kohdeosoite saadaan laskemalla yhteen käytetyn osoi- 
terekisterin ja indeksirekisterin sekä välittömän offsetin arvot. Indeksirekisteri 
voi olla mikä tahansa osoite- tai datarekisteri. Jos indeksirekisterin nimen pe- 
rään liitetään .L, käytetään laskussa kaikkia indeksirekisterin bittejä. Jos liite jä- 
tetään pois tai se on W, käytetään vain indeksirekisterin 16 alinta bittiä. Indeksi- 
rekisterin arvo tulkitaan etumerkillisenä. 

Tässä osoitusmuodossa offset on jälleen etumerkillinen luku, mutta sen koko 
on vain 8 bittiä. 

Syntaksi: MOVEB D0,5(A0,D 1) ; tallentaa DO:n arvon 

; muistipaikkaan, jonka osoite 

; on AO:n arvo + D1:n arvo + 5. 
; Vain 16 alinta DI:n bittiä 

; vaikuttaa. 
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Gy ona tarkastellaan MC68000:n käskykantaa käskytyypeittäin. Tar- 
kemmat selostukset käskyjen toiminnasta löytyvät liitteestä A. Joidenkin 
käskyjen käytöstä on annettu lyhyt esimerkki. Esimerkit eivät välttämättä toimi 
sellaisinaan, vaan ne on liitettävä osaksi suurempaa kokonaisuutta. 

MC68000:a ohjelmoitaessa on määrättävä halutun toiminnan koko. Useim- 
mista yleisistä käskyistä on valittavissa joko 8-, 16- tai 32-bittinen muoto. Käy- 
tettäessä muita kuin 32-bittisiä muotoja ylimmät kohteen bitit säilyvät muuttu- 
mattomina. Siten esimerkiksi ADD.W 45,DO lisää DO:n alimpiin 16 bittiin lu- 
vun 5, mutta jättää ylemmät 16 bittiä ennalleen. 

Käskyissä, joissa on kaksi parametria, oikeanpuoleinen on kohde ja vasem- 
manpuoleinen lähde. Siten esimerkiksi MOVE-käskyssä tieto siirtyy vasemma!- 
ta oikealle, mikä onkin loogisempaa kuin useissa prosessoreissa käytetty oikeal- 
ta vasemmalle siirto. 

MC68000:ssa kaikki datarekisterit (eräänlaiset akut) ovat keskenään samanar- 
voisia, samoin osoiterekisterit. Siksi kaikissa käskyissä voi käyttää mitä tahansa 
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rekisteriä tarpeen mukaan. 


Tiedonvälitystä 


Tiedon siirtäminen MC68000:lla on mahdollista rekisterien välillä, rekisteri- 
en ja muistin välillä sekä suoraan kahden muistiosoitteen välillä. 

MC68000:ssa ei ole varsinaisia pinoon tallennus- ja sieltä lataamiskäsky jä 
(push ja pull), vaan niiden sijasta voidaan käyttää esimerkiksi autoindeksoituja 
osoitusmuotoja (predecrement ja postincrement) tai erityistä MOVEM-käskyä, 
jolla voidaan siirtää useita rekisterejä kerralla. 

MC68000 ei myöskään sisällä lohkonsiirtokäskyjä, vaan ne on tehtävä käyttä- 
en yksinkertaista silmukkaa. 


toiminta 

vaihtaa rekisterien sisällöt keskenään 
lataa tehollisen osoitteen osoiterekisteriin 
varaa työtilaa pinomuistista 

siirtää lähteen kohteeseen 

siirtää lähteen osoiterekisteriin 


siirtää useita rekisterejä 

siirtää tietoa erityisille I/O-piireille 

siirtää pienen luvun (-128...127) datarekisteriin 
tallentaa tehollisen osoitteen pinoon 

vapauttaa pinomuistista varatun alueen 


Tiedon siirtoon käytettävät käskyt. 


Matematiikkaa kaikille 


MC68000 sisältää varsin monipuoliset käskyt kokonaisluvuilla laskentaa var- 
ten. Käytettävissä on binääriaritmetiikan lisäksi myös BCD-aritmetiikka, jossa 
käytettävä lukualue on 4 bitin binääriluvuille tyypillisen 0...15 sijasta 0...9. Täl- 
löin yksi tavu sisältää kaksi BCD-numeroa eli luvun 0...99. 

Kerto- ja jakolaskua varten on sekä etumerkilliset että merkittömät käskyt. 
Kertolaskussa kerrottava ja kertoja tulkitaan 16-bittisiksi, tulo on 32-bittinen. Ja- 
kolaskussa jaettava on 32-bittinen ja jakaja 16-bittinen, kuten myös osamäärä ja 


jakojäännös. Jakolaskussa voi tapahtua ylivuoto, jota ilmaisee V-lippu. 
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käsky toiminta 

ABCD lisää lähteen kohteeseen BCD-aritmetiikkaa 
käyttäen 

ADD lisää lähteen kohteeseen 

ADDA lisää lähteen osoiterekisteriin 

ADDI lisää välittömän luvun kohteeseen 

ADDO lisää pienen luvun (1...8) kohteeseen 

ADDX lisää lähteen ja X-lipun kohteeseen 

CLR nollaa kohteen 

CMP vertaa lähdettä kohteeseen 

CMPA vertaa lähdettä osoiterekisteriin 

CMPI vertaa välitöntä lukua kohteeseen 

CMPM vertaa kahden muistipaikan arvoja toisiinsa 

DIVS etumerkillinen jakolasku 32 / 16 - 16 

DIVU etumerkitön jakolasku 32 / 16 - 16 

EXT laajentaa luvun 8 - 16 tai 16 - 32 

MULS etumerkillinen kertolasku 16 * 16 - 32 

MULU etumerkitön kertolasku 16 * 16 - 32 

NBCD negatoi BCD-luvun (laskee 2:n komplementin) 

NEG negatoi luvun (laskee 2:n komplementin) 

NEGX negatoi luvun huomioiden X-lipun arvon 

SBCD vähentää lähteen kohteesta BCD-aritmetiikkaa 
käyttäen 

SUB vähentää lähteen kohteesta | 

SUBA vähentää lähteen osoiterekisteristä 

SUBI vähentää välittömän luvun kohteesta 

SUBO vähentää pienen luvun (1...8) kohteesta 

SUBX vähentää lähteen ja X-lipun kohteesta 

Aritmetiikkakäskyt N N N 


SI. 
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Logiikkaa - tosi on! 


Loogiset käskyt käsittelevät operandeja biteittäin muodostaen saman toimin- 
non (JA, TAI, ETAI tai EI) operandien vastinbittien välille. Laskusäännöt on esi- 
tetty taulukossa 1. 

JA-toiminto vaatii, että molempien operandien bitti on ykkönen, jotta tulosbit- 
ti olisi ykkönen. TAI-toiminnolle riittää, että ainakin toisen (tai molempien) ope- 
randin bitti on ykkönen. ETAI vaatii, että toisen operandin bitti on ykkönen, toi- 
nen nolla. EI on yksinkertaisin toiminto, se vain kääntää operandin bittien tilat 
päinvastaisiksi. 

Loogisia operaatioita ovat JA (AND), TAI (OR) ja ETAI (EOR). Tähän ryh- 
mään on otettu myös TST-käsky (testaa parametrin arvoa), NOT (vaihtaa kaikki- 
en bittien tilan päinvastaiseksi) ja Scc (ehdollinen operandin asetus). 


toiminta 

looginen JA-toiminto lähteen ja kohteen välillä 
looginen JA välittömän luvun ja kohteen välillä 
looginen ETAI (Ehdoton TAI) lähteen ja kohteen välillä 
looginen ETAI välittömän luvun ja kohteen välillä 
muodostaa kohteesta 1 komplementin eli vaihtaa 


kaikkien bittien tilat käänteisiksi 

looginen TAI lähteen ja kohteen välillä 

looginen TAI välittömän luvun ja kohteen välillä 

asettaa kohteen bitin 7 jos ehto on tosi 

testaa kohteen arvon ja asettaa tilarekisterin liput vastaavasti 


Taulukko 1. Loogiset toiminnot. 


AB AJAB A TAIB A ETAIB = EIA EIB 


00 O 0 0 1 1 
01 O l l 1 0 
10 O 1 1 0 | 
kd l 0 0 0) 


Liput hulmuavat 


MC68000 ei sisällä erityisiä käskyjä tilarekisterin lippujen asettamiseksi tai 
nollaamiseksi. Sen sijaan käytetään vastaavia loogisia toimintoja (JA, TAI, 
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ETAD), joiden kohteena on tilarekisteri. Näiden käskyjen avulla voidaan halutta- 
essa asettaa tai nollata useita bittejä samanaikaisesti. 

ANDI fluku,CCR 

nollaa tilarekisteristä ne bitit (liput), joita vastaavat bitit luvussa ovat nollia; 
ei vaikuta niihin lippuihin, joita vastaavat bitit ovat ykkösiä 

EORI fluku,CCR 

vaihtaa tilarekisterin niiden lippujen tilat päinvastaisiksi, joita vastaavat lu- 
vun bitit ovat ykkösiä; ei vaikuta muihin lippuihin 

ORI fluku,CCR 

asettaa tilarekisterin liput, joita vastaavat bitit luvussa ovat ykkösiä; ei vaiku- 
ta muihin lippuihin 


Bittien kiertoa 


Siirto- ja kierrätyskäskyilla voidaan siirtää datarekisterin tai muistipaikan si- 
sältämää lukua biteittäin vasemmalle tai oikealle. Jos siirrettävä luku on datare- 
kisterissä, sitä voidaan siirtää useita bittejä kerralla, jos muistissa, vain yksi bitti 
kerrallaan. 

Siirtokäskyissä rekisteristä pois siirtyvät bitit menevät X- ja C-lippuihin, kier- 
rätyskäskyissä ne palautetaan rekisterin toiseen päähän. 

Aritmeettisissa siirtokäskyissä otetaan huomioon luvun etumerkki, jolloin 
merkki säilyy myös oikealle siirrettäessä. Loogisissa siirroissa merkistä taas ei 
välitetä, vaan arvoa käsitellään tavallisena bittikombinaationa. 


toiminta 

siirtää kohdetta aritmeettisesti vasemmalle 
siirtää kohdetta aritmeettisesti oikealle 
siirtää kohdetta loogisesti vasemmalle 
siirtää kohdetta loogisesti oikealle 


kierrättää kohdetta vasemmalle 

kierrättää kohdetta oikealle 

kierrättää kohdetta vasemmalle X-lipun kautta 
kierrättää kohdetta oikealle X-lipun kautta 

vaihtaa datarekisterin ylemmän ja alemman puolikkaan 
keskenään 


Ykkönen vai nolla? 


Bitinkäsittelykäskyilla voidaan asettaa, nollata ja testata yksittäisiä bittejä ja 
vaihtaa niiden tiloja. 
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toiminta 
vaihtaa bitin tilan päinvastaiseksi 
nollaa bitin 


asettaa bitin 
testaa bitin tilan 


Hyppy sinne, toinen tänne 


Usein on tarpeen haarautua ohjelmassa eri koodiin, jos tietty ehto toteutuu tai 
kutsua esimerkiksi käyttöjärjestelmän rutiineja. Seuraavassa on lueteltu tähän 
tarkoitukseen soveltuvat käskyt. 


toiminta 

ehdollinen, suhteellinen hyppy 

ehdoton, suhteellinen hyppy 

ehdoton suhteellinen aliohjelmakutsu 
testaa ehdon, pienentää laskuria ja hyppää 
ehdoton hyppy 


ehdoton aliohjelmakutsu 

ei toimintaa 

palaa exception-rutiinista 

lataa tilarekisterin pinomuistista ja palaa aliohjelmasta 
palaa aliohjelmasta, jota on kutsuttu BSR- tai JSR-käskyllä 


Bittejä pinoon 


MC68000 ei sisällä tavanomaisia push- ja pull-tyyppisiä käskyjä pinonkäsitte- 
lyä varten. Koska pino-osoittimena toimii yksi osoiterekisteri, voidaan lähes 
kaikkia käskyjä käyttää myös pino-operaatioissa. Haluttaessa tallentaa rekisterin 
DO arvo pinoon käytetään käskyä MOVE.L D0,-(A7) ja haluttaessa ottaa DO:n 
arvo pinosta käskyä MOVE.L (A7)+,D0. Samoin voidaan esimerkiksi luku 
12345 tallentaa pinoon käskyllä MOVE L 412345,-(A7). Tarvittaessa voidaan 
pinon päällimmäiseen lukuun lisätä haluttu arvo: ADD. L f$100,(A7). Kuten ha- 
vaitaan, pinon käsittely on huomattavasti monipuolisempaa kuin pelkkien push- 
ja pull-käskyjen avulla. 

Aliohjelmien tms. yhteydessä on usein tarpeen tallentaa useita rekisterejä pi- 
noon ja vastaavasti aliohjelman lopussa ottaa ne pois pinosta. Tähän tarkoituk- 
seen soveltuu MOVEM-käsky, joka pystyy siirtämään jopa kaikki rekisterit 
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muistiin tai sieltä pois. Kaikki datarekisterit tallentuvat pinoon seuraavasti: 

MOVEM L D0-D7,-(A7) 

Kaikki rekisterit saadaan pois pinosta käskyllä 

MOVEML (A7)+,D0-D7/A0-A6 

Huomaa, ettei rekisteriä A7 eli pino-osoitinta kannata tallentaa pinoon! MO- 
VEM-käsky hyväksyy minkä tahansa kombinaation rekistereistä. Siis esimerkik- 
si MOVEM.L D0/D2/D7/A2,-(A7) on mahdollinen. 

Yhden rekisterin siirtäminen pinoon käy nopeimmin MOVE-käskyllä, mutta 
useita rekisterejä siirrettäessä kannattaa käyttää MOVEM-käskyä. Pinosta on AlI- 
NA otettava yhtä monta rekisteriä kuin sinne on pantukin, sillä muutoin esimer- 
kiksi aliohjelmien paluuosoitteet noudetaan väärästä paikasta. 

Koska mikä tahansa osoiterekisteri voi toimia pino-osoittimena, voi ohjelmoi- 
ja halutessaan luoda omia pinojaan ja käyttää MOVE- tai MOVEM-käskyissä 
vaikkapa osoiterekisteriä A5. Tällöin on huomattava, että JSR-, BSR- ja RTS- 
käskyt käyttävät aina pino-osoittimena AT:ää. 


Kummajaisia 


Lisäksi MC68000 sisältää useita muita käskyjä, joiden avulla voidaan mm. ai- 
heuttaa exception-tiloja, nollata ulkoiset piirit ja palata normaalitilaan. Nämä 
käskyt on esitelty liitteessä A. 


Exception-toiminnot 


MC68000:ssa kaikkia keskeytyksiä ja virherutiineja kutsutaan yhteisellä ni- 
mellä exception-rutiinit. Niille on yhteistä se, että prosessori tallentaa ennen ex- 
ception-rutiiniin siirtymistä prosessorin sen hetkisen tilan ja ohjelmalaskurin pi- 
nomuistiin. Kaikkien exception-rutiinien ajon aikana prosessori toimii Super- 
visor-tilassa. Tavallisesti ohjelmissa ei tarvitse huomioida exception-rutiineja, 
koska käyttöjärjestelmä hoitaa keskeytykset automaattisesti. 


Exception-tyypit ja vektorit 

MC68000:n vektoritaulukko (1024 tavua) alkaa osoitteesta $00000000. Vek- 
torit merkityksineen on lueteltu taulukossa 2. 

Amigan käyttöjärjestelmä (Exec) on suunniteltu suhteellisen yksinkertaiseksi 
exception-rutiinien osalta. Jos yritetään esimerkiksi jakaa nollalla, Exec vain 
pulpauttaa kuvaruudun yläreunaan guru-ilmoituksen. Kuitenkin käyttäjän ohjel- 
ma voi asettaa haluamansa vektorit ja estää siten käyttöjärjestelmän ja koko ko- 
neen kaatumisen. Tämä ei kuitenkaan ole välttämättä yksinkertaista eikä sitä sik- 
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si voi suositella aloitteleville Amigan ohjelmoijille. 

Mikäli haluaa käyttää ohjelmissaan keskeytyksiä, kannattaa vektoreiden 
muuttaminen jättää käyttöjärjestelmän huoleksi. Execistä löytyy rutiinit oman 
keskeytysrutiinin liittämiseksi koneen entisiin rutiineihin. Myös moniajokäyttö- 
järjestelmän normaalin toiminnan takaamiseksi on tärkeää, ettei mene omin päin 
muuttelemaan systeemin parametreja. 

Kirjan loppuosassa on lisätietoa guru-ilmoituksista ja niiden mahdollisista ai- 
heuttajista. 

MC68000-sarjan prosessoreiden exception-toiminnasta on tarkempaa tietoa 
mm. ao. prosessorien datalehdissä ja MC68000-ohjelmoijan oppaissa (liite E). 
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osoite 
$0000 
$0004 
$0008 
$000c 


$0010- 
$0014 


$0018 
$001c 
$0020 


$0024 
$0028 


$002c 


$0030 
$0034 
$0038 
$003c 
$0040- 
$0060 
$0064 
$0068 
$006c 
$0070 
$0074 
$0078 
$007c 
32-47 $0080- 
48-58 $00c0- 
59-63 $00ec- 
64-255 $0100- 
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exception-tyyppi 

Reset - kylmäkäynnistyksen pino-osoittimen arvo 
Reset - kylmäkäynnistysrutiinin alkuosoite 
väylävirhe 

osoitevirhe - yritetty osoittaa sanaa tai pitkää sanaa 
parittomassa osoitteessa 

laiton käsky - 68000 yritti suorittaa käskyn, jota se ei tunne 
jako nollalla - DIVS- tai DIVU-käskylle annettiin 
jakajaksi nolla 

CHK-käsky 

TRAPV-käsky 

privilege violation - yritettiin suorittaa käyttäjän tilassa 
käsky, jonka saa suorittaa vain Supervisor-tilassa 
Trace-moodi (ohjelman suoritus käsky kerrallaan) 
A-rivi-emulaattori (prosessori yritti suorittaa käskyn, 
joka alkaa binäärikombinaatiolla %1010 eli $a) 
F-rivi-emulaattori (prosessori yritti suorittaa käskyn, 
joka alkaa binäärikombinaatiolla %1111 eli $£) 
(varattu) 

apuprosessorin virhe, ei käytössä perus- Amigassa 
muotovirhe 

alustamaton keskeytys, ei käytössä Amigassa 
(varattu) 

keskeytysvektori, kun keskeyttävä oheispiiri ei vastaa 
keskeytysvektori, autovector (taso 1) 
keskeytysvektori, autovector (taso 2) 
keskeytysvektori, autovector (taso 3) 
keskeytysvektori, autovector (taso 4) 
keskeytysvektori, autovector (taso 5) 
keskeytysvektori, autovector (taso 6) 
keskeytysvektori, autovector (taso 7) 

TRAP-käskyn vektorit 0...15 

oheisprosessorin vektoreita, ei käytössä perus-Amigassa 
(varattu) 

käyttäjän määriteltävät vektorit 


Taulukko 2. Exception-vektorit 
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MC68000:lla 
ohjelmointi 


() hjelmointi MC68000:lla on helppoa pienen totuttelun jälkeen. Yllättäviä 
ongelmia saattaa aiheutua eri osoitusmuotojen ja operaatioiden kokojen 
suhteen. On erittäin tärkeää oppia erottamaan toisistaan esimerkiksi välitön (im- 
mediate) ja absoluuttinen osoitusmuoto. Myös sekaannukset operaatioiden koos- 
sa saattavat helposti aiheuttaa virhetoimintoja. Silmukkalaskuri voidaan esimer- 
kiksi alustaa 8-bittisenä (MOVE.B), jolloin ylimmissä biteissä ollut arvo säilyy 
muuttumattomana. Jos silmukassa käytetään 32 bitin vähennyskäskyä 
(SUBO.L) ja vaikkapa BNE-käskyä, myös ylimmät bitit otetaan huomioon vä- 
hennys- ja hyppykäskyissä. Myös jakolaskukäskyn käytössä kannattaa olla tark- 
kana: Vaikka jakaja ja osamäärä ovat 16-bittisiä, jaettava on silti 32-bittinen. 
Siksi jaettaessa 16-bittisiä lukuja on jaettavana toimivan datarekisterin ylemmät 
bitit nollattava ennen jakolaskua. Tämä onnistuu nopeiten käyttämällä MO- 
VEO.L 40,Dn -käskyä ennen varsinaisen jaettavan lataamista Dn-rekisteriin. 

Esimerkki 1. 

Lasketaan summa 8 luvusta, jotka ovat muistissa alkaen osoitteesta LUVUT. 
Luvut ovat 32-bittisiä. Tulos tallennetaan muistiin osoitteeseen SUMMA. 

sum: —move.] — $4LUVUT,a0 ; otetaan ensimmäisen luvun osoite 


moveg.1 48,d0 ; lukujen määrä 
moveg.! 40,d1 ; nollataan summa 
loop: —add.l (a0)+,d1 ; lisätään summaan yksi luvuista 
subg.l H1,d0 ; pienennetään laskuria 
bne loop ; toistetaan, kunnes nolla 


move.]1 d1,SUMMA ; tallennetaan tulos 
rts 


Ohjelman toiminta on seuraava: Aluksi siirretään ensimmäisen yhteenlasket- 
tavan osoite osoiterekisteriin a0. Näin kaikkia lukuja voidaan osoittaa yksinker- 
taisella silmukalla käyttäen postincrement-osoitusmuotoa, joka kasvattaa itses- 
tään a0:n arvoa siten, että se osoittaa seuraavaan laskettavan lukuun. LUVUT on 
tässä määritelty assemblerin egu-komennolla. Seuraavaksi asetetaan d0:aan lu- 
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kujen määrä käyttäen MOVEO- käskyä, joka on nopeampi ja vie vähemmän 
muistia kuin vastaava MOVE.L. MOVEO:n käyttö on mahdollista aina, kun da- 
tarekisteriin halutaan luku, jonka arvo on väliltä -128...127. MOVEO- käskyllä 
nollataan myös d1, johon lukujen summa lasketaan. 

Silmukassa loop lisätään d1:een a0:n ilmaisemassa osoitteessa oleva luku. Sa- 
malla aO kasvaa neljällä (koska käytetään .L- muotoa). Sitten pienennetään yk- 
kösellä jäljellä olevien lukujen määrää, joka on dO:ssa. Koska vähennettävä luku 
on väliltä 1...8, voidaan käyttää SUBO-käskyä, joka säästää jälleen aikaa ja 
muistia SUB-käskyyn verrattuna. SUBO asettaa tilarekisterin liput vähennyslas- 
kun tuloksen mukaan. Jos tulos ei ollut nolla, palataan BNE-käskyllä takaisin 
loop-silmukkaan. Kun tulos on nolla, tallennetaan tulos d1:stä SUMMA-muisti- 
paikkaan, jonka on oltava 32-bittinen. 

Esimerkki 2. 

Lasketaan merkkijonon pituus merkkeinä. Merkkijonon alkuosoite on AL- 
KU, pituus palautetaan muistipaikassa PITUUS. Merkkijonon on päätyttävä nol- 
latavuun. 

len: move.] —HALKU,.a0 — ; otetaan merkkijonon alkuosoite 

move.] — a0.al ; kopioidaan se toiseenkin 
; rekisteriin 


loop: —tst.b (a0)+ ; testataan, onko tavu nolla 
bne loop ; Jos ei, jatketaan 
suba.1 al.a0 : vähennetään alkuosoite 
subg.1 H1,a0 ; poistetaan nollatavu 
move. — a0,PITUUS — ; tallennetaan pituus 
rts 


Ohjelman toiminta: Aluksi merkkijonon alkuosoite siirretään a0:aan ja 
al:een. Sitten testataan alusta lähtien merkkijonon merkkejä, kunnes löytyy nol- 
la. Tällöin bne-hyppy ei enää toteudu, vaan ohjelma poistuu silmukasta. Silmu- 
kasta poistuttaessa a0 osoittaa merkkijonon lopussa olevaa nollaa seuraavaan ta- 
vuun. Kun a0:sta vähennetään al (merkkijonon ensimmäisen merkin osoite) ja 
ykkönen, saadaan a0:aan merkkijonon pituus merkkeinä. Se tallennetaan muis- 
tiin PITUUS-paikkaan (32-bittinen). 
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Esimerkki 3. 
Kopioidaan LUKUM tavua tietoa paikasta PAIK I paikkaan PAIK2. 
copy: move.!| HPAIKI1,a0 — ; otetaan lähdeosoite 
move.| FPAIK2,a1 — ; otetaan kohdeosoite 
move.1 FLUKUM.dO ; otetaan tavujen lukumäärä 
loop: move.b (a0)+,(a1)+ — ; siirretään yksi tavu 
subg.1 f1,d0 ; pienennetään laskuria 
bne loop ; toistetaan tarvittava määrä 
Its 


Ohjelman toiminta: Aluksi ladataan osoiterekistereihin a0 ja al siirron lähde- 
ja kohdeosoitteet sekä d0:aan siirrettävien tavujen lukumäärä. loop-silmukassa 
kopioidaan tavuja a0:n osoittamasta paikasta a1:n osoittamaan paikkaan. Koska 
käytetään jälleen autoinkrementoivaa osoitusta, osoiterekisterien arvot kasvavat 
automaattisesti ykkösen kerrallaan (tavuosoitus!). Jokaisella silmukan kierrok- 
sella dO:aa pienennetään yhdellä, kunnes tulos oli nolla, jolloin silmukka päät- 
tyy. 

Esimerkki 4. 

Liitetään kaksi merkkijonoa peräkkäin. Ohjelma olettaa, että merkkijono A 
halutaan liittää jonon B jälkeen. Jonon B jäljessä on oltava riittävä tila merkki- 
jonolle A. Molempien merkkijonojen on päätyttävä nollatavuun, tulos päättyy 
myös nollatavuun. 


add: — move! = $JONO A,a0 ; otetaan merkkijonon A osoite 

move.]! — $4JONO Bal ; otetaan merkkijonon B osoite 
Ipl: — tst.b (a1)+ ; etsitään jonon B loppu 

bne Ip1 

subg.1 H1 al ; osoitin takaisin nollatavuun 
1p2: —move.b — (a0)+,(a1)+ ; kopioidaan merkkejä, 

bne Ip2 ; kunnes jono A loppuu 

rts 


Ohjelman toiminta: Aluksi ladataan osoiterekistereihin aO ja a1 merkki- 
jonojen alkuosoitteet. Silmukassa Ip! etsitään jonon B lopussa oleva nollatavu 
ja pienennetään al:tä lopuksi (koska tst.b (a1)+ kasvatti al:n arvon ohi nollata- 
vun). Silmukassa Ip2 kopioidaan merkkijonosta A merkkejä jonoon B kunnes jo- 
non A loppumista ilmaiseva nollatavu on siirretty. 

Seuraavassa luvussa tarkastellaan Amigan käyttöjärjestelmää ja sen käyttä- 
mistä omista ohjelmista käsin. Luvun lopussa käsitellään myös assemblerohjel- 
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mien liittämistä C-kielisten ohjelmien yhteyteen. 

Monipuolisempia ohjelmointiesimerkkejä löytyy kirjan lopussa olevasta liit- 
teestä ja oheiselta levykkeeltä. Esimerkeistä oppii paljon erityisesti Amigan oh- 
jelmointiin liittyviä asioita. Tarkemmat tiedot MC68000:n käskykannasta löyty- 
vät liitteestä A, jossa on esitelty aakkosjärjestyksessä kaikki prosessorin käskyt 
esimerkkeineen. 
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migan käyttöjärjestelmää kutsutaan 

nimellä Exec. Se poikkeaa edukseen 
lähes kaikkien mikrotietokoneiden käyttö- 
järjestelmistä monipuolisuutensa ja kehit- 
tyneisyytensä vuoksi. Tärkeimpiä eroja 
ovat mm. moniajomahdollisuus ja Amigan 
erityisominaisuuksien huomioon ottami- 
nen. Ilman kehittynyttä käyttöjärjestelmää 
ja kovon erityisominaisuuksia Amiga olisi 
vain "tavallinen" mikrotietokone. 


Amigan metkut 


Amigan ohjelmointi poikkeaa melkoisesti perinteisten mikrotietokoneiden oh- 
jelmoinnista. Osasyynä on tietysti tehokkaampi prosessori, suurempi muistiava- 
ruus ja monimutkaisempi kovo. Suurimman eron kuitenkin muodostavat kehitty- 
nyt käyttöjärjestelmä ja moniajoympäristö. 


Moniajo 


Koska Amigassa on ohjelmien moniajomahdollisuus, ei muistissa voi olla mi- 
tään kiinteitä osoitteita puskureille, näyttömuistille tai ohjelmakoodille. Sen si- 
jaan muistia varataan vapaalta alueelta aina sitä tarvittaessa. Ainoa "tunnettu" 
muistipaikka Amigassa onkin osoite $0004, josta löytyy Exec-kirjaston al- 
kuosoite. 

Jotta useita ohjelmia voisi pyöriä koneessa samanaikaisesti, ne on pystyttävä 
sijoittamaan mihin tahansa kohtaan muistissa. Koska tällaisten ohjelmien kirjoit- 
taminen ei kuitenkaan ole aina mahdollista, Amigan käyttöjärjestelmä tekee oh- 
jelmiin tarvittavat muutokset niiden muistiin lataamisen aikana. Jotta käyttöjär- 
jestelmä pystyisi tekemään nuo muutokset on sen saatava ohjelmasta paljon 
enemmän tietoa kuin pelkkä ohjelmakoodi. Siksi ohjelmien tekovaiheessa 
ALINK- ja BLINK-linkkerit liittävät ohjelmatiedostoihin niiden uudelleensijoit- 
tamiseen tarvittavan informaation. 
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Jaetut resurssit 


Moniajon vuoksi mikään ohjelma ei saa käyttää esimerkiksi rinnakkaisporttia 
noin vain - toinen ohjelmahan saattaisi olla käyttämässä sitä samaan aikaan ja tu- 
loksena olisi sekasotku. Samoin näyttöön tulostus, näppäimistön luku jne. vaati- 
vat omat hienoutensa, jotta useita ohjelmia todella voitaisiin käyttää koneessa sa- 
manaikaisesti. Jotta moniajo olisi käytännössä mahdollista, on kaikkien ohjelmi- 
en käytettävä kaikkia koneen resursseja käyttöjärjestelmän rutiinien välityksellä. 
Näin käyttöjärjestelmä pystyy pitämään kirjaa siitä, kuka käyttää mitäkin port- 
tia, äänikanavaa, levyasemaa jne. Sitten Exec voi pyytää jotakin ohjelmaa odot- 
tamaan, kunnes kirjoitinportti vapautuu tai ilmoittaa, ettei portti ole juuri nyt 
käytettävissä. Näin kaksi ohjelmaa ei pysty tulostamaan tekstiä samanaikaisesti 
(jolloin esimerkiksi joka toinen merkki saattaisi olla peräisin toisesta ohjelmas- 
ta). 


Ajan säästöä 


Moniajoympäristössä ohjelma ei koskaan saa pyöriä ns. busy-loop-silmukas- 
sa esimerkiksi odottamassa näppäimen painallusta. Mikä tahansa "tavallinen" 
silmukka kuluttaa nimittäin kaiken saatavissa olevan prosessoriajan ja hidastaa 
siten huomattavasti kaikkien koneessa olevien ohjelmien toimintaa. Viiveitä ei 
myöskään saisi tehdä silmukalla, vaan esimerkiksi dos-kirjaston Delay-rutiinil- 
la, jolta voi pyytää halutun viiveen 20 millisekunnin tarkkuudella. Delay-rutiini 
käynnistää viiveen ajaksi muita ohjelmia, jotka siten saavat lisää prosessoriai- 
kaa. Yleensä kaikkien tapahtumien odottamiseen käytetään Wait-rutiinia, jolla 
pystyy ilmaisemaan käytännöllisesti katsoen kaikki tapahtumat (näppäimen pai- 
nallukset, hiiren liikuttamisen, valikoiden käytön, levykkeiden vaihtamisen 
jne.). Lähemmin ohjelmointitekniikasta ohjelmaesimerkkien yhteydessä. 


Kirjastot 


Amigan käyttöjärjestelmä jakautuu useisiin osiin, joita kutsutaan kirjastoiksi. 
Jokainen kirjasto on kokoelma johonkin aihepiiriin liittyviä käyttöjärjestelmäru- 
tiineja. Lisäksi kirjastoon voi kuulua muuta, lähinnä käyttöjärjestelmän käyttöön 
tarkoitettua tietoa. Yhteensä kirjastot sisältävät yli 300 erillistä käyttäjän kutsut- 
tavaa aliohjelmaa. 

Amigan käyttöjärjestelmään kuuluu kahden tyyppisiä kirjastoja. Ensimmäi- 
nen tyyppi on ns. resident-kirjastot, jotka sijaitsevat koneen ROM-muistissa 
(Amiga-1000:ssa nämä sijaitsevat ns. KickStart-RAMissa). Ne ovat aina käyttö- 
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valmiina eikä niitä tarvitse ladata levyltä. Näitä ovat esimerkiksi Exec- ja Dos- 
kirjastot. Toinen tyyppi on ns. disk-resident-kirjastot. Nämä kirjastot sijaitsevat 
levyllä ja ne ladataan koneen RAM-muitstiin vain silloin, kun niitä tarvitaan. Tä- 
mä säästää muistia varsinkin niiden kirjastojen kohdalla, joita tarvitaan harvoin. 
Disk-resident-tyyppisiä kirjastoja ovat esimerkiksi translator.library (muuntaa 
englanninkielisen tekstin äännemerkeiksi) ja diskfont.library (käsittelee levyllä 
olevat merkkifontit). 


Kirjastojen käytöstä 


Amigan käyttöjärjestelmän kutsuminen on käytännössä eri kirjastoihin kuulu- 
vien rutiinien kutsumista. Jotta jotakin rutiinia voitaisiin käyttää, on tiedettävä, 
missä kirjastossa se sijaitsee, mikä on sen kutsuosoite ja mitkä ovat rutiinin tar- 
vitsemat parametrit. 

Kirjastorutiineja käytettäessä on muistettava, että rutiineilla on oikeus muut- 
taa rekisterien DO, D1, AO ja A1 arvoja. Niinpä näiden rekisterien sisältöön ei 
kannata luottaa rutiinikutsun jälkeen. Vain DO sisältää varsinaista rutiinin anta- 
maa tietoa, muiden arvot voivat olla mielivaltaisia. 


Kirjastojen avaaminen 


Aivan ensimmäiseksi ohjelman alussa on avattava kaikki ne kirjastot, joihin 
kuuluvia rutiineja ohjelmassa aiotaan käyttää. Kirjaston avaaminen tarkoittaa 
käytännössä sitä, että käyttöjärjestelmältä kysytään, missä muistiosoitteessa ko. 
kirjasto sijaitsee. Samalla Exec saa tiedon siitä, että jokin ohjelma haluaa käyt- 
tetään ladata levyltä. Ellei kirjastoa löydy sieltäkään, ohjelmalle palautetaan vir- 
heilmoitus. Muussa tapauksessa ohjelmalle annetaan kirjaston perusosoite. Kun 
ohjelma päättyy, kuuluu hyviin tapoihin sulkea kaikki kirjastot, jotka ohjelma 
avasi. Näin käyttöjärjestelmä voi poistaa muistista ne disk-resident-tyyppiset kir- 
jastot, joita kukaan ei enää käytä ja vapauttaa niiden vaatiman muistitilan. 

Kirjastot avataan OpenLibrary-rutiinilla, joka sijaitsee Exec-kirjastossa. Exec- 
voitaisiin avata muita kirjastoja. Exec-kirjaston perusosoite löytyy Amigan aino- 
asta "tunnetusta" osoitteesta $0004. Se pysyy muuttumattomana kaikissa käyttö- 
järjestelmäversioissa ja Amigoissa. Muiden kirjastojen osoitteet on aina selvitet- 
tävä ohjelmaa käynnistettäessä OpenLibrary-kutsulla. 

Kuten myöhemmin huomataan, yksi OpenLibrary-rutiinin parametreista on 
kirjaston nimi. Alla olevassa taulukossa on lueteltu Amigan käyttöjärjestelmään 
kuuluvien kirjastojen nimet. Niitä käytettäessä nimen loppuun on lisättävä nolla- 
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tavu, joka ilmaisee nimen päättymisen. Esimerkiksi C-kielellä ohjelmoitaessa 

on tärkeää, että kirjaston perusosoite (base address) tallennetaan oikean nimi- 
seen muuttujaan. Assemblerohjelmoijaa tämä rajoitus ei koske, koska osoittimis- 
ta joutuu joka tapauksessa huolehtimaan itse. Taulukossa on annettu kullekin 
kirjastolle vastaavan osoittimen nimi. 


kirjaston nimi osoittimen nimi 
clist.library ClistBase 
diskfont.library DiskfontBase 
dos.library DosBase 
exec.library ExecBase ($0004) 
graphics.library GfxBase 

icon library IconBase 
intuition.library IntuitionBase 
layers.library LayersBase 
mathffp.library MathBase 
mathieedoubbas.library MathleeeDoubBasBase 
mathtrans.library MathTransBase 
ramlib.library - 

translator.library TranslatorBase 


Parametrien välittäminen, structure 


Kun kirjastot on avattu, voidaan niissä olevia rutiineja käyttää. Useimmille ru- 
tiineille annetaan niiden tarvitsemat syöttötiedot (parametrit) prosessorin data- 
ja osoiterekistereissä. Jotkut rutiinit, kuten Open Window (avaa ikkunan näyt- 
töön), tarvitsevat kuitenkin niin monta parametria, etteivät prosessorin rekisterit 
riitä. Siksi joudutaan käyttämään ns. structure-menetelmää. 

Structure on joukko tavuja, sanoja ja pitkiä sanoja. C-kielessä structure sisäl- 
tää ryhmän erilaisia muuttujia, jotka on koottu saman nimen alle. Structurea voi- 
daan verrata suureen laatikkoon, jossa on useita lokeroita. Jokainen lokero, 
muuttuja, sisältää vain yhden tiedon, jotka voivat kaikki olla eri tyyppiä. Kaikki- 
en lokeroiden sisältämät tiedot yhdessä kuvaavat jonkin suuremman kokonaisuu- 
den. Esimerkiksi laatikossa nimeltä Pallo voisi olla lokerot Hinta, Koko, Väri ja 
Tyyppi. Kun kaikkien lokeroiden tiedot yhdistetään, saadaan selville, millainen 
pallo on kyseessä (vaikkapa Kolmen markan Pieni Sininen Superpallo). Esimer- 
kissä laatikko vastaa structurea ja jokainen lokero omaa muuttujaansa. 

Seuraavassa on malli yksinkertaisesta structuresta, johon kuuluu kaksi sanaa 
(x- ja y-koordinaatit), pitkä sana (tekstin alkuosoite) ja yksi tavu (tekstin väri). 
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Kaikki nämä muuttujat muodostavat structuren nimeltä Malli, jonka alla on 
structure Teksti. 


Malli dc.w xcoord ; x-koordinaatin tila 16 bittiä 
dc.w ycoord : y-koordinaatin tila 16 bittiä 
dc.1 Teksti ; osoitin tekstiin 
dc.b color ; väriarvo, 8 bittiä 

Teksti dc.b —"Osoitin text ilmoittaa tämän tekstin " 


dc.b — "alkuosoitteen.",0 

Yllä olevassa esimerkissä on toinenkin huomionarvoinen seikka: Koska teksti 
voi olla mielivaltaisen pituinen, ei sitä voida sijoittaa keskelle structurea (tällöin- 
hän jäljempänä olevien muuttujien paikka structuren alkuun nähden ei olisi va- 
kio). Sen sijaan structureen sijoitetaan 32-bittinen osoite, joka kertoo tekstin si- 
joitusosoitteen. Tätä 32-bittistä lukua kutsutaan osoittimeksi (pointer). Tekstin 
päättymisen ilmaisee sen loppuun sijoitettu nollatavu. 

Assemblerohjelmoijalle structure on yksinkertaisesti vain ryhmä muistipaik- 
koja, joilla jokaisella on oma merkityksensä. Tärkeintä on, että tietty arvo löy- 
tyy oikeankokoisena (tavu/sana/pitkä sana) oikeasta kohtaa structuren alusta läh- 
tien laskettuna. Siksi erillisten tietojen on aina oltava structuressa samassa järjes- 
tyksessä. Koko structuren idea perustuu siihen, että kun tietyt parametrit koo- 
taan yhdeksi ryhmäksi sovitun kaavan mukaisesti, ei tarvitse tuntea kuin ryhmän 
alkuosoite ja tuo kaava, jotta voitaisiin käsitellä ryhmän kaikkia parametreja. 

Esimerkissämme Malli on structuren alkuosoite. Kun lisäksi tiedetään, että x- 
ja y-koordinaatit vievät molemmat kaksi tavua, saadaan selville tekstiosoittimen 
osoite: Malli + 2 + 2 = Malli + 4. Väri taas löytyy osoitteesta Malli +2+2+4 
= Malli + 8. 

Jos nyt joku rutiini tarvitsisi syöttötiedoikseen mainitut x- ja y-koordinaatit, 
tekstin ja värin, rutiinille tarvitsisi antaa vain määritellyn structuren alkuosoite 
(Malli) sen sijaan, että kaikki erilliset parametrit annettaisiin omissa rekistereis- 
sään. Näin monimutkaisenkin rutiinin parametrien välittämiseen riittää yksi ai- 
noa prosessorin rekisteri. Myöhemmissä esimerkkiohjelmissa on esitetty structu- 
reiden käyttö käytännön ohjelmoinnissa. 


Kirjastorutiinien kutsuminen 


Seuraavassa esimerkissä avataan ensin dos-kirjasto. Sitten kutsutaan dos-kir- 
jastoon kuuluvaa Delay-rutiinia, jolla muodostetaan viiden sekunnin viive. Lo- 
puksi suljetaan dos-kirjasto ja poistutaan ohjelmasta. 

TÄRKEÄÄ: Kun kirjaston rutiinia kutsutaan, osoiterekisterissä a6 on oltava 
ao. kirjaston perusosoite. Koska liitteessä B luetellut rutiinien osoitteet ovat suh- 
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teellisia kirjaston perusosoitteeseen, kutsuminen käy helposti käyttämällä seuraa- 


vaa muotoa: 


JSR OFFSET(A6) 
kunhan a6 sisältää oikean perusosoitteen. Rutiineja EI VOI kutsua absoluutti- 
sella JSR-käskyllä. Ennen rutiinin kutsumista ladataan tarvittavat parametrit oi- 


keisiin rekistereihin. 


Käyttöjärjestelmän rutiinit saattavat muuttaa rekisterien dO, d1, a0 ja a1 arvo- 
ja. Koskaan ei kannata luottaa siihen, että näiden rekisterien arvot säilyvät ru- 
tiinikutsun aikana, vaikka rutiinille ei annettaisikaan niissä mitään parametreja. 
Muiden rekisterien arvot sen sijaan säilyvät ennallaan. Ne rutiinit, jotka palautta- 
vat kutsujalle jonkin tuloksen, antavat sen yleensä rekisterissä do. 


Esimerkki 1. 


; aluksi määritellään rutiinien kutsuosoitteiden offsetit: 


OpenLibrary 
CloseLibrary 
Delay 
movem.! 
move.] 

lea 

move.] 


jsr 
move.1 
beg 


move.1 
move.1 


Jsr 

move.1 
move.1 

Jsr 

ei auennut: 
movem.1 


move.1 
rts 
DosBase: 


egu = -$0228 
egu = -$019e 
egu = -$00c6 


d2-d7/a2-a6, -(a7) 
10,d0 

dosname,al 

$4,a6 


OpenLibrary(a6) 
d0,DosBase 


ei auennut 


1250,d1 
DosBase,a6 


Delay(a6) 
DosBase,al 

$4,a6 
CloseLibrary(a6) 
(a7)+, d2-d7/a2-a6 
40,d0 


dc.1 0 


; exec-kirjastossa 

; exec-kirjastossa 

; dos-kirjastossa 

; tallennetaan rekisterit 

; kirjastoversio >= 0 

; kirjaston nimen osoitin 
; exec-kirjaston 

; perusosoite 

; avaa dos-kirjaston 

; tallentaa perusosoitteen 
; hyppy, jos dos ei 

; auennut 

; viive 250/50 s=5s 


- ; otetaan dos-kirjaston 


; perusosoite 

; kutsutaan viiverutiinia 
; otetaan dos-perusosoite 
; exec-perusosoite 

; suljetaan dos-kirjasto 


; otetaan rekisterit 

; pinosta 

; ei virhettä! 

; poistutaan ohjelmasta 
; tila Dos-osoitteelle 


' 


54 


Exec 


vät liitteestä B. Ensimmäinen käsky tallentaa rekisterit D2...D7 ja A2...A6 pino- 
muistiin. Sitten ladataan dO0:aan vanhimman hyväksyttävän kirjaston ver- 
sionumero. Yleensä kannattaa valita numero nolla, jolloin kaikki kirjastoversiot 
kelpaavat. Joskus tarvitaan kuitenkin rutiineja, joita ei ole vanhimmissa kirjasto- 
versioissa (eli vanhimmissa käyttöjärjestelmäversioissa). 

Seuraavaksi A1:een ladataan kirjaston nimen osoitin, a6:een exec-kirjaston 
perusosoite (koska OpenLibrary sijaitsee exec-kirjastossa) ja kutsutaan OpenLi- 
brary-rutiinia. OpenLibrary palauttaa dO:ssa avattavan kirjaston (tässä tapaukses- 
sa dos.library) perusosoitteen. Jos kirjastoa ei jostain syystä voitu avata, dO:n ar- 
vo on nolla. Tällöin poistutaan ohjelmasta. 

Kun kirjasto on avattu ja sen perusosoite tallennettu muistiin, voidaan kutsua 
Delay-rutiinia muodostamaan haluttu viiden sekunnin viive. Viiveen pituus an- 
netaan Delay-rutiinille d1:ssä viideskymmenesosa sekunteina. a6:een ladataan 
nyt dos-kirjaston perusosoite, koska Delay sijaitsee siinä. Delay-rutiinin kutsu- 
minen tapahtuu samoin kuin OpenLibrarynkin. Seuraavaksi ladataan a1:een sul- 
jettavan kirjaston perusosoite ja a6:een exec-kirjaston osoite sekä kutsutaan Clo- 
seLibrary- rutiinia. Lopuksi ladataan d0:aan nolla merkiksi siitä, että ohjelman 
ajon aikana ei tapahtunut virhettä ja poistutaan RTS-käskyllä. 

Esimerkki 2. 

; Avataan dos-, graphics- ja intuition-kirjastot. 


OpenLibrary egu = -$0228 ; exec-kirjastossa 
CloseLibrary egu = -$019e€ ; exec-kirjastossa . 
movem.l d2-d7/a2-a6, -(a7) — ; tallennetaan rekisterit 
move.] 10,d0 ; kirjastoversio >= 0 
lea dosname,a1 ; kirjaston nimen osoitin 
move.] $4.a6 : exec-kirjaston 
; perusosoite 
jsr OpenLibrary(a6) ; avaa dos-kirjaston 
move.] d0,DosBase ; tallentaa perusosoitteen 
beg dos ei auennut ; hyppy, jos dos ei 
; auennut 
move] 40,d0 ; kirjastoversio >= 0 
lea gfxname,a1 ; kirjaston nimen osoitin 
; exec-kirjaston 4 
; perusosoite on valmiina 
jsr OpenLibrary(a6) ; avaa graphics-kirjaston 
move.l d0,GfxBase ; tallentaa perusosoitteen 
beg gfx ei auennut ; hyppy, jos gfx ei 
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; auennut 
move.1 H0,d0 ; kirjastoversio >= 0 
lea intuiname,a] ; kirjaston nimen osoitin 
move.l $4,a6 ; Exec-kirjaston 

; perusosoite on valmiina 
jsr OpenLibrary(a6) ; avaa intuition-kirjaston 
move.] d0,IntuitionBase ; tallentaa perusosoitteen 
beg intui ei auennut ; hyppy, jos intuition ei 

; auennut 

; varsinainen ohjelma tähän 
move.l IntuitionBase,a1 ; otetaan intuition- 

; perusosoite 
move.] $4,a6 ; exec-perusosoite 
jsr CloseLibrary(a6) ; suljetaan intuition- 

; kirjasto 
intui ei auennut: 
move.1 GfxBase,al ; otetaan gfx-perusosoite 
move.I1 $4,36 ; exec-perusosoite 
jsr —CloseLibrary(a6) ; suljetaan gfx-kirjasto 
gfx ei auennut: 
move.] DosBase,al ; otetaan dos-perusosoite 
move.1 $4,a6 ; exec-perusosoite 
jJsr CloseLibrary(a6) ; suljetaan dos-kirjasto 


dos ei auennut: 
movem.] —(a7)+, d2-d7/a2-a6 — ; otetaan rekisterit 


; pinosta 
move.1 40,d0 ; ei virhettä! 
rts ; poistutaan ohjelmasta 
IntuitionBase: dc] O ; tila Intuition- 

; perusosoitteelle 
GfxBase: dc.l 0 ; tila Gfx-osoitteelle 
DosBase: dc.l 0 ; tila Dos-osoitteelle 


Makroassemblerilla ohjelmoitaessa voidaan käyttää amiga.lib-kirjastossa 
määriteltyjä selväkielisiä kutsuoffsetteja. Tällöin linkkerille on annettava kirjas- 
toksi amiga.lib ja ohjelman alussa on käytetyt offsetit määriteltävä ulkoisiksi 
viittauksiksi KREF-komennolla. 

Kutsuoffsettien nimet muodostetaan seuraavasti: NIMI = LVO + rutiinin 
nimi; esimerkiksi Open-rutiinin offset on nimeltään LVOOpen. LVO- kirjai- 
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met tulevat sanoista Library Vector Offset. Koska offsetit on määritelty ami- 
ga.lib-kirjastossa, ei käyttäjän tarvitse tuntea niiden todellisia arvoja lainkaan. 

Jos ohjelma käyttää OpenLibrary-, CloseLibrary- ja Delay- rutiineja, sen alus- 
sa on makroassemlerille tehtävä seuraavat määritykset: 

XREF LVOOpenLibrary 

XREF LVOCloseLibrary 

XREF  LVODelay 

Myöhemmin rutiineja voidaan käyttää offsettien avulla: 

jSr  LVOOpenLibrary(a6) 

JSr LVOCloseLibrary(a6) 


C-kielisiin ohjelmiin liittyminen 

C-kääntäjät lisäävät käytettyjen funktioiden ja muuttujien nimien alkuun alle- 
viivausviivan ( ). Siksi haluttaessa tehdä C- kieleen esimerkiksi funktio nimeltä 
"koe" on sen nimeksi assemblerissa annettava " koe". Assembler-kääntäjälle on 
myös kerrottava, että tietyn aliohjelman tai muistipaikan halutaan olevan myös 
muiden ohjelman osien käytössä, ts. että C-kielinen koodi voi kutsua assembler- 
kielistä aliohjelmaa. Tämä tapahtuu XDEF-komennolla seuraavasti: 

XDEF — koe 

XDEF — muuttuja 

— koe: 

«koodi... 

— muuttuja: 

dc.1 $12345678 

Nyt assemblerkääntäjä ilmoittaa linkkerille koe-nimisen aliohjelman ja 
— muuttuja-nimisen muistiosoitteen sijainnit, jolloin linkkeri voi korvata niihin 
tapahtuvat viittaukset esimerkiksi C-kielisessä koodissa ao. osoitteilla. Tällöin 
määriteltyjä symboleja voidaan käyttää C-ohjelmasta käsin samalla tavoin kuin 
C:n omia symbolejakin. 

Kun C-kielisestä ohjelmasta kutsutaan assemblerilla tehtyä rutiinia C-ohjel- 
ma tallentaa rutiinin parametrit pinomuistiin. Assemblerrutiini voi lukea halu- 
mansa parametrit pinosta milloin tahansa. Kun pino-osoittimen arvoa merkitään 
SP:llä, saadaan rutiinin parametrien osoitteet seuraavasti: 


SP rutiinin paluuosoite (RTS-käskyä varten) 
SP +4 ensimmäinen parametri 
SP +8 toinen parametri 


SP + 12 — kolmas parametri jne. 
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Jos assemblerkielisen rutiinin halutaan palauttavan jonkin arvon C-ohjelmal- 
le, tulee haluttu arvo ladata rekisteriin DO ennen RTS-käskyä. Jos palautettava 
arvo on 8- tai 16-bittinen (char- ja short-tyyppiset muuttujat), se tulee antaa 
D0O:n alimmissa biteissä. Jos arvo on 32-bittinen (muut kuin char- ja short-tyyp- 
piset muuttujat), se täyttää koko rekisterin. Käytettäessä double-tyyppisiä muut- 
tujia tulos palautetaan DO:ssa ja D1:ssä. 

Assemblerkieliset aliohjelmat eivät saa muuttaa prosessorin rekisterien 
D4...D7 ja A2...A6 arvoja. Jos ohjelmassa tarvitaan näitä rekisterejä, on ne ensin 
tallennettava pinomuistiin. 

Kirjan lopussa on listattu laajempia ohjelmaesimerkkejä, joita kannattaa tut- 
kia. Esimerkit löytyvät myös mukana olevalta levykkeeltä, joten niiden osia voi 
helposti käyttää omissa ohjelmissa. Esimerkeistä käy hyvin ilmi, miten kirjasto- 
rutiinien kutsuminen Amigassa tapahtuu. Metacomcolla tehdyissä esimerkeissä 
käytetään myös runsaasti ohjelmointityötä vähentäviä makroja. 

Seuraavassa luvussa tarkastellaan yksityiskohtaisesti useita tärkeitä käyttöjär- 
jestelmän rutiineja, jotka on ryhmitelty aakkosjärjestykseen kirjastoittain. Liit- 
teessä B on lueteltu kaikki käyttöjärjestelmän rutiinit, niiden parametrit ja kut- 
suoffsetit. Taulukon perusteella voi käyttää myös sellaisia rutiineja, joita seuraa- 
vassa luvussa ei ole esitelty. 
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K edellisessä luvussa todettiin, Amigan käyttöjärjestelmä sisältää useita 
kirjastoja. Jokaiseen kirjastoon on koottu joukko tiettyyn aihepiiriin kuulu- 
via käyttöjärjestelmärutiineja, joita on yhteensä yli 400. Kirjastoista useimmin 
käytettyjä ovat Exec, Dos, Graphics ja Intuition. Tässä luvussa tarkastellaan joi- 
takin kirjastoihin kuuluvia rutiineja lähemmin. Kirjan lopussa olevassa esimerk- 
kiosassa on malli useimpien rutiinien käytöstä. Lisätietoa kirjastorutiineista löy- 
tyy esimerkiksi kirjasta ROM Kernel Reference Manual: Libraries and Devices. 

Kirjastorutiineja kutsuttaessa kannattaa muistaa, että rutiinit saattavat muut- 
taa dO:n, d1:n, a0:n ja al:n arvoja. Muut rekisterit sen sijaan säilyvät muuttumat- 
tomina. 

Osa kirjastoista sijaitsee kiinteästi KickStart- eli käyttöjärjestelmämuistissa, 
osa taas ladataan levykkeeltä. Levykkeeltä ladattavia kirjastoja kutsutaan englan- 
ninkielisessä kirjallisuudessa disk-resident-tyyppisiksi, kiinteästi muistissa ole- 
via ROM-residenteiksi. Levykkeellä libs:-hakemistossa olevia kirjastoja avatta- 
essa Amiga pyytää levyasemaan sitä levykettä, jolla kone käynnistettiin ellei 
libs:-hakemistoa ole assign-komennolla osoitettu jollekin muulle levykkeelle. 
Jos haluttua kirjastoa ei löydy sen hetkisestä libs:-hakemistosta, OpenLibrary-ru- 
tiini palauttaa kutsujalleen virheilmoituksen. 
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DOS-kirjasto 


Dos-kirjasto sisältää yleisiä tiedostojen käsittelyyn liittyviä rutiineja, kuten 
Open, Close, Read ja Write. Dos-kirjasto on avattava Exec-kirjaston OpenLibra- 
ry-rutiinilla ennen siinä olevien rutiinien käyttöä. Dos-kirjasto sijaitsee KickS- 
tart-ROMissa, joten sitä ei tarvitse ladata levykkeeltä ensi kertaa avattaessa. 

Seuraavassa esitellään lähemmin Dos-kirjaston hyödyllisimpiä rutiineja. 


CLOSE 


Nimi: Close -- sulkee lukemista ja kirjoittamista varten avatun tiedoston. 

Kutsu: Close (D1) 

Parametrit: D1 = Open-rutiinin antama tiedoston structuren osoitin 

Toiminta: Close-rutiini sulkee Open-rutiinilla avatun tiedoston. Kaikki ohjel- 
massa avatut tiedostot on suljettava ennen siitä poistumista. Jos esimerkiksi rin- 
nakkaisportti jätetään avoimeksi, mikään ohjelma ei voi käyttää sitä ennen ko- 
neen uudelleenkäynnistystä. 


DATESTAMP 


Nimi: DateStamp -- lukee systeemin reaaliaikakellon ajan 

Kutsu: DateStamp (D1) 

Parametrit: D1 = Muistiosoite, johon aika tallennetaan 

Toiminta: Prosessori kirjoittaa Amigan ajanlaskun alusta kuluneiden päivien, 
päivän alusta kuluneiden minuuttien ja minuutin alusta kuluneiden viideskym- 
menesosasekuntien lukumäärät 32-bittisinä lukuina muistiin alkaen osoitteesta, 
joka annettiin D1:ssä. Osoitteen täytyy olla parillinen. Osoitteessa on oltava ti- 
laa kolmelle 32-bittiselle luvulle. Ensimmäinen luku ilmoittaa päivien, toinen 


Tulos: Kelloaika tallentuu D1:ssä annettuun osoitteeseen. 
DELAY 
Nimi: Delay -- muodostaa halutun viiveen 


Kutsu: Delay (D1) 

Parametrit: DI = Viive viideskymmenesosasekunteina 

Toiminta: Delay-rutiini on tarkoitettu pysäyttämään ohjelma halutuksi ajaksi 
viideskymmenesosasekunnin tarkkuudella. Rutiinin ajon aikana prosessori on 
vapaa suorittamaan muita tehtäviä, joten Delay-rutiinia pitäisi käyttää aina taval- 
lisen viivesilmukan sijasta. 
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DELETEFILE 


Nimi: DeleteFile -- poistaa tiedoston tai hakemiston 

Kutsu: DO = DeleteFile (D1) 

Parametrit: D1 = osoitin nimen merkkijonoon, joka päättyy nollaan 

Toiminta: DeleteFile-rutiinia käytetään tiedoston tai hakemiston tuhoamiseen 
levykkeeltä. Huomaa, että vain tyhjä hakemisto voidaan tuhota. 


Tulos: DO <> 0, jos toiminta onnistui 
INPUT 
Nimi: Input -- selvittää ohjelman alkuperäisen syöttötiedoston 
Kutsu: DO = Input() 
Parametrit: - 


Toiminta: D0:aan luetaan ohjelman syöttötiedoston structuren osoite. Jos oh- 
jelma käynnistettiin normaalisti CLI:stä käsin, tiedosto on CLI-ikkuna. Kun täs- 
tä tiedostosta luetaan tietoa Read-rutiinilla, se luetaan näppäimistöltä. Huomaa, 
että tieto saadaan vasta, kun käyttäjä painaa <RETURN> ao. CLI-ikkunassa. 
DO:ssa palautettu arvo vastaa Open-rutiinilta saatavaa osoitinta. 


Tulos: DO = syöttötiedoston structuren osoite 
IOERR 

Nimi: IoErr -- lukee edellisen operaation virhekoodin 

Kutsu: DO = IoErr() 

Parametrit: - 


Toiminta: DO:aan luetaan edellisen 1/O-operaation mahdollisesti asettama vir- 
hekoodi. Koodien merkitykset on lueteltu header-tiedostossa "dos.i". 
Tulos: DO = virhekoodi 


OPEN 
Nimi: Open -- aukaisee tiedoston lukemista ja/tai kirjoittamista varten. 
Kutsu: DO = Open (DI, D2) 
Parametrit: D1 = Tiedoston nimen osoitin 
D2 = Moodi: 


1005 aukaisee jo olemassaolevan tiedoston lukemista ja kirjoittamista 
varten. 
1006 luo uuden tiedoston tuhoten samalla mahdollisen vanhan 


Toiminta: Avaa tiedoston levylle tai muulle laitteelle. Jos tiedostoa ci löy- 
dy(tai ei muusta syystä voida avata), rutiini palauttaa DO:ssa arvon nolla. 
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Tiedoston ei välttämättä tarvitse olla varsinainen levytiedosto vaan sen voi 
avata jollekin laitteelle, kuten rinnakkaisportille. Laite valitaan tiedoston nimen 
"vulla: 

"PAR:" avaa rinnakkaisportin lukemista ja kirjoittamista varten; "SER:" vas- 
1a sarjaporttia(nopeus, pariteetti yms. määrätään Preferences-ohjelman asetuk- 
illa); "CON:" avaa CLI-tyyppisen ikkunan ja "RAW:" ikkunan, josta tietoa voi- 
aan lukea myös merkki kerrallaan. 

Kaikkiin em. erikoistiedostoihin voidaan kirjoittaa Write-rutiinilla ja niistä 
'oidaan lukea Read-rutiinilla. CON:- ja RAW:-tiedostoissa luettava tieto tulee 
läppäimistöltä ja kirjoitettu menee ikkunaan. 

Tulos: DO = osoitin tiedoston structureen. Tätä osoitinta tarvitaan Read-, 
Write- ja Close-rutiinien yhteydessä. Jos DO = O, tiedoston avaaminen ei onnis- 
tunut. Tällöin varsinainen virhekoodi voidaan selvittää IoErr-rutiinia käyttämäl- 
lä. 


OUTPUT 
Nimi: Output -- selvittää ohjelman alkuperäisen tulostustiedoston 
Kutsu: DO = Output() 
Parametrit: - 


Toiminta: DO:aan luetaan ohjelman tulostustiedoston structuren osoite. Jos 
ohjelma käynnistettiin normaalisti CLI:stä käsin, tiedosto on CLI-ikkuna. Kun 
tähän tiedostoon lähetetään tietoa Write-rutiinilla, se tulostuu CLI-ikkunaan. 
DO:ssa palautettu arvo vastaa Open-rutiinilta saatavaa osoitinta. 


Tulos: DO = tulostustiedoston structuren osoite 
READ 
Nimi: Read -- lukee tavuja tiedostosta 


Kutsu: DO = Read (DI, D2, D3) 

Parametrit: D1 = tiedoston structuren osoitin, joka saatiin Open-rutiinilta tie- 
dostoa avattaessa; D2 = osoitin puskurin alkuun; D3 = luettavien tavujen määrä 

Toiminta: Read-rutiinin avulla voit lukea avaamastasi tiedostosta haluamasi 
tavumäärän tietoa puskuriin. Rutiinille annettavan tavumäärän on aina oltava 
pienempi kuin tavuille varatun puskurin koko. Puskurin voi varata lukemista 
varten esimerkiksi AllocMem- tai AllocAbs-rutiinien avulla. Read-rutiinilla kan- 
nattaa lukea merkkejä mahdollisimman monta kerralla, sillä näin säästetään ai- 
kaa. Mikäli ohjelma käsittelee luettuja merkkejä yksitellen, kannattaa varata esi- 
merkiksi 512 tavun puskuri, joka luetaan kerralla levyltä. Sen jälkeen ohjelma 
voi lukea merkkejä yksitellen puskurista. DO sisältää Read-rutiinin lukemien 
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merkkien määrän. Jos tiedosto loppuu tai tapahtuu muu virhe, DO on pienempi 


Tulos: DO = tiedostosta luettujen tavujen määrä 
RENAME 
Nimi: Rename -- nimeää uudelleen tiedoston tai hakemiston 


Kutsu: DO = Rename (DI, D2) 

Parametrit: D1 =osoitin entisen nimen merkkijonoon, joka päättyy nollaan; 
D2 =osoitin uuden nimen merkkijonoon, joka päättyy nollaan 

Toiminta: Rename-rutiini vaihtaa levykkeellä olevan tiedoston tai hakemis- 
ton nimen. Toiminta vastaa CLI:n rename-komentoa. 

Rename-rutiinille annetaan tiedoston tai hakemiston vanhan ja uuden nimen 
osoittimet. Rutiini palauttaa DO:ssa tiedon toiminnan onnistumisesta. Jos DO = 
0, uudelleen nimeäminen ei onnistunut. 


Tulos: DO <>0, jos toiminta onnistui 
SEEK 
Nimi: Seek -- siirtyy haluttuun kohtaan tiedostossa 


Kutsu: DO = Seek (D1, D2, D3) 

Parametrit: D1 = Open-rutiinilta saatu tiedoston structuren osoitin; D2 = koh- 
ta, johon halutaan siirtyä(merkkeinä); D3 = moodi 

Toiminta: Kun moodi on -1, ilmaisee D2 merkin numeron tiedoston alusta 
laskettuna. Kun moodi on O, siirrytään tiedostossa nykyisestä kohdasta D2:n il- 
tossa kohtaan, joka on D2:n määrä merkkejä tiedoston lopusta alkuunpäin. Jos 
esimerkiksi haluat siirtyä tiedostossa viimeisen tavun kohdalle aseta moodiksi 
yksi ja kohdaksi nolla. 

Seek antaa DO:ssa entisen sijaintikohdan merkkeinä tiedoston alusta laskettu- 
na. Tiedoston pituuden voi selvittää etsimällä kaksi kertaa tiedoston lopun(moo- 
di = 1, kohta = 0). Toisella kerralla Seek palauttaa tiedoston viimeisen merkin 
numeron. 

Tulos: DO = ennen Seek-rutiinin kutsumista voimassa ollut paikka 
tiedoston alusta. 


WRITE 

Nimi: Write -- kirjoittaa tavuja tiedostoon 

Kutsu: DO = Write (D1, D2, D3) 

Parametrit: D1 = Open-rutiinin antama tiedoston structuren osoitin; D2 = tal- 
lennettavan tiedon alkuosoite; D3 = tallennettavan tiedon tavumäärä 
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Toiminta: Wfrite-rutiini kirjoittaa tiedostoon sen nykyisestä kohdasta alkaen 
D3:ssa ilmoitetun määrän tavuja, jotka sijaitsevat muistissa D2:ssa ilmoitetusta 
=-1, on tapahtunut virhe, jonka voi lukea IoErr-rutiinilla. 

Tulos: DO = tallennettujen tavujen lukumäärä 


Exec-kirjasto 


Exec-kirjasto sisältää yleisiä perustason rutiineja, kuten AllocMem, Free- 
Mem, OpenLibrary, CloseLibrary, Disable ja Enable. Lisäksi Execiin kuuluvat 
kaikki keskeytysten ja moniajon hallintaan sekä viestien lähettämiseen ja vas- 
taanottoon tarvittavat rutiinit. 

Exec-kirjastoa ei tarvitse avata, vaan sen perusosoite sijaitsee muistissa osoit- 
teessa $0004. Execin rutiineja kutsuttaessa käytetään perusosoitteen hakemiseen 
käskyä MOVEA.L $0004,A6. Exec-kirjasto on sijaitsee KickStart-ROM:ssa, jo- 
ten se on aina käyttövalmis. 

Seuraavassa esitellään lähemmin joitakin Exec-kirjaston hyödyllisimpiä ru- 
tiineja. 


ADDINTSERVER 

Nimi: AddlntServer -- liittää systeemiin käyttäjän keskeytysrutiinin 

Kutsu: AddlntServer (DO[0-4], A 1) 

Parametrit: DO = Paula-piirin keskeytysbitin numero; A1 = Interrupt-structu- 
ren osoite 

Toiminta: AddlntServer lisää käyttöjärjestelmän keskeytyslistaan uuden rutii- 
nin. DO:ssa ilmoitetaan, mistä keskeytysbitistä keskeytysrutiinin halutaan akti- 
voituvan. Bitit ovat seuraavat: 

bitti merkitys nimi 


0 RS232lähetyspuskuri tyhjä INTB TBE 

1 levyasema: lohko siirretty INTB DSKBLK 
2 — ohjelmiston keskeytyspyyntö INTB SOFTINT 
3 I/O-portit ja laskurit INTB PORTS 

4 Copper-apuprosessori INTB COPER 

5 — vertical blanking INTB VERTB 
6 blitterin toiminto valmis INTB BLIT 

7 äänikanava O valmis INTB AUDO 

8 äänikanava 1 valmis INTB AUDI 

9 äänikanava 2 valmis INTB AUD2 

10 äänikanava 3 valmis INTB AUD3 
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11 RS232 vast.ottopuskuri täysi INTB RBF 
12 levyaseman synkronointi INTB DSKSYNC 
13 ulkoinen keskeytys INTB EXTER 


Keskeytyksiä varten tarvittava Interrupt-structure on seuraava(structure sisäl- 
tää Node-structuren, joka on seuraavassa purettu auki): 


Interrupt: 

dc.1 0 ; seuraava node(käyttöjärjestelmä asettaa) 
dc.1 0) ; edellinen node(käyttöjärjestelmä asettaa) 
dc.b 2 ; nodetyyppi = NT INTERRUPT 

dc.b 0 ; keskeytyksen prioriteetti 

dc.1 name ;keskeytyksen nimi 

dc.1 0 ; keskeytysrutiinille välitettävä tieto 

dc.1 iroutine; keskeytysrutiinin alkuosoite 

name: 

dc.b "Oma keskeytys" ,0 

iroutine: ; itse keskeytysrutiini 


moveg.] —%1,d0 ; tieto: keskeytys käsitelty 

Its ; palataan käyttöjärjestelmään 

Lisätietoa keskeytysten käsittelyyn liittyvistä structureista löytyy mm. levyk- 
keellä olevista include-tiedostoista. Keskeytysrutiini saa käyttää vapaasti proses- 
sorin DO/D1-, A0/A 1- ja AS-rekisterejä. Mikäli se tarvitsee muita rekisterejä, on 
ne ensin tallennettava pinomuistiin. Keskeytysrutiineja on kahta lajia: server- ja 
handler-tyyppiset rutiinit. Server-tyyppisiä rutiineja käytetään PORTS-, COPER- 
, VERTB-, BLIT- ja EXTER-keskeytysten yhteydessä. Käyttöjärjestelmä ketjut- 
taa server-rutiinit peräkkäin niiden prioriteeteista riippuvaan järjestykseen. Ru- 
tiineja kutsutaan peräkkäin, kunnes jokin niistä palauttaa prosessorin Z-lipun 
nollattuna. Käyttöjärjestelmän kutsuessa server-tyyppistä rutiinia prosessorin re- 
kisterit sisältävät seuraavat arvot: 

DO tuntematon 

DI tuntematon 

AO apuprosessorien osoite(nykyisin $dff000) 

Al osoittaa Interrupt-structuren tietopaikkaan 

AS5 kutsutun keskeytysrutiinin alkuosoite 

Näitä rekisterejä saa vapaasti käyttää Server-keskeytysrutiinin aikana. Koska 
Exec lataa aina em. rekistereihin nämä arvot, kannattaa niitä pyrkiä hyödyntä- 
mään keskeytysrutiinissa. Esimerkiksi apuprosessorien osoittamiseen voi käyt- 
tää AO-rekisteriä sopivan offset-arvon kanssa. Tämä on nopeampaa kuin abso- 
luuttinen osoitus. 
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Handler-tyyppinen keskeytysrutiini on aina itsenäinen. Tätä keskeytystyyppiä 
käytetään esimerkiksi RS232-portin yhteydessä, koska yhtä Paula-piirin keskey- 
tysbittiä vastaa tällöin vain yksi keskeytysrutiini. Käyttöjärjestelmän kutsuessa 
handler-rutiinia prosessorin rekisterit sisältävät seuraavat arvot: 

DO tuntematon 

D1 INTENAR- ja INTREOR-rekisterien arvojen JA-tulos 

AO —apuprosessorien osoite(nykyisin $dff000) 

Al — osoittaa Interrupt-structuren tietopaikkaan 

A5 — kutsutun keskeytysrutiinin alkuosoite 

A6 Exec-kirjaston perusosoite 

Näitä rekisterejä saa vapaasti käyttää handler-keskeytysrutiinin aikana. Kos- 
ka Exec lataa aina em. rekistereihin nämä arvot, kannattaa niitä pyrkiä hyödyntä- 
mään keskeytysrutiinissa. Esimerkiksi apuprosessorien osoittamiseen voi käyt- 
tää AO-rekisteriä sopivan offset-arvon kanssa, mikä on nopeampaa kuin muistin 
absoluuttinen osoittaminen. 

Käytännön esimerkki keskeytysten käytöstä kirjan lopussa olevassa esimerk- 
kiohjelmassa. 

Keskeytykset voidaan kieltää Disable-rutiinilla ja sallia Enable-rutiinilla. 


ALLOCABS 


Nimi: AllocAbs -- varaa muistia halutun määrän halutusta paikasta 

Kutsu: AllocAbs (DO, A1) 
kaen muistia varataan 

Toiminta: AllocAbs-rutiini varaa muistia absoluuttisesta osoitteesta alkaen ha- 
lutun määrän. DO ilmoittaa, saatiinko haluttu muistialue varattua vai ei. 

Tulos: DO = tieto muistinvarauksen onnistumisesta 


ALLOCMEM 
— Nimi: AllocMem -- varaa muistia halutun määrän vapaana olevalta 
alueelta 


Kutsu: AllocMem (D0, D1) 


luttu tyyppi 

Toiminta: Rutiini varaa vapaana olevalta muistialueelta halutun tavumäärän 
taan DO:ssa ja tyyppi D1:ssä. DO:ssa palautuu varatun muistin alkuosoite tai nol- 
la, mikäli muistia ei ollut riittävästi vapaana. Eri muistityyppejä vastaavat bitit 
on määritelty "exec/memory.i"-tiedostossa. 


66 


Kirjastot Exec-kirjasto 


Jos halutaan, että jokin tieto(kuva, ääni jne.) on apuprosessorien saatavilla, se 
on sijoitettava ns. CHIP-RAM-alueelle($00000000...$0007ffff). Tällöin muisti- 
tyypiksi on valittava MEMF CHIP eli 2. Laajentamattomassa Amigassa(512k) 
ei ole lainkaan FAST- tyyppistä muistia. 

Eri bittien merkitykset: 

MEMF PUBLIC muisti on aina käytettävissä(ei pankitusta tms.), 

bitin numero 0 
MEMF CHIP muisti sijaitsee apuprosessorien osoitealueella, 
bitin numero 1 
MEMF FAST muistiei sijaitse apuprosessorien osoitealueella, 
bitin numero 2 
MEMF CLEAR muisti täytetään nollilla varaamisen yhteydessä, 
bitin numero 16 
MEMF LARGEST käytetään lähinnä AvailMem-rutiinin yhteydessä 
haluttaessa saada selville suurin yhtenäinen vapaa 
muistialue, bitin numero 17 

Tulos: DO = varatun muistialueen alkuosoite. Jos DO = 0, muistissa ei 

ollut vapaana riittävän suurta yhtenäistä aluetta. 


AVAILMEM 


Nimi: AvailMem -- laskee vapaana olevan muistin määrän 
Kutsu: AvailMem (D1) 
Parametrit: D1 = muistin tyyppi 
Toiminta: Rutiini laskee halutun tyyppisen vapaana olevan muistin määrän ja 
palauttaa arvon DO:ssa. Jos halutaan saada selville suurimman yhtenäisen muisti- 
alueen koko, on DI:een asetettava bitti MEMF LARGEST. MEMF CHIPillä 
saadaan tietää CHIP-RAM-muistissa vapaana oleva tila, MEMF FAST laskee 
FAST-RAMin vapaan tilan. 
Laajentamattomassa Amigassa(512k) ei ole lainkaan FAST-tyyppistä muistia. 
Eri bittien merkitykset: 
MEMF PUBLIC muisti on aina käytettävissä(ei pankitusta tms.), 
bitin numero 0 
MEMF CHIP muisti sijaitsee apuprosessorien osoitealueella, 
bitin numero 1 
MEMF FAST muistiei sijaitse apuprosessorien osoitealueella, 
bitin numero 2 
MEMF LARGESTkäytetään haluttaessa saada selville suurin yhtenäinen 
vapaa muistialue, bitin numero 17 
Tulos: DO = vapaan muistin määrä tavuina 
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CLOSELIBRARY 

Nimi: CloseLibrary -- sulkee halutun kirjaston 

Kutsu: CloseLibrary (A 1) 

Parametrit: A1 =kirjaston perusosoite 

Toiminta: CloseLibrary sulkee OpenLibrary-rutiinilla avatun kirjaston. Kaik- 
ki avatut kirjastot tulisi sulkea ohjelman lopussa, jotta käyttöjärjestelmä voisi 
poistaa muistista ne disk-resident-tyyppiset(levyltä ladattavat) kirjastot, joita yk- 
sikään ohjelma ei enää käytä. Näin kirjaston vaatima muisti voidaan vapauttaa 
muuta käyttöä varten. Kirjaston sulkemisen jälkeen siinä olevia rutiineja ei enää 
saa kutsua. 


Tulos: Kirjasto suljetaan. 
DISABLE 
Nimi: Disable -- kieltää keskeytyspyynnöt 
Kutsu: Disable() 
Parametrit: - 


Toiminta: Disable-rutiini kieltää keskeytyspyynnöt nollaamalla Paula-piirin 
INTENA-rekisterin bitin 14. Jos Disable-rutiinia kutsutaan useita kertoja, on 
Enable-rutiinia kutsuttava yhtä monta kertaa ennen kuin keskeytykset jälleen sal- 
litaan. Wait-rutiini sallii keskeytykset riippumatta Disable-rutiinilla asetetusta, 
mutta palauttaa jälleen alkuperäisen tilan Wait-rutiinista poistuttaessa. 

Myös normaali tehtävän vaihto estyy, koska se tapahtuu tavallisesti keskey- 
tysten aikana. Siksi kaikki muut koneessa pyörivät ohjelmat pysähtyvät siksi ai- 
kaa, kun keskeytykset ovat estettyinä. 

Koska käyttöjärjestelmän toiminta perustuu pitkälti keskeytysten käyttöön, se 
saattaa häiriintyä pahasti, mikäli keskeytykset ovat pitkiä aikoja kiellettynä. 
Yleensä keskeytyksiä ei saisi kieltää yli 250 mikrosekunnin pituisiksi ajoiksi 
kerrallaan. 

Keskeytykset sallitaan suorittamalla Enable-rutiini. 


Tulos: Kaikki Paula-piirin kautta tulevat keskeytykset estetään. 
ENABLE 

Kutsu: Enable() 

Parametrit: - 


Toiminta: Enable-rutiini sallii Disable-rutiinilla kielletyt keskeytyspyynnöt 
asettamalla Paula-piirin INTENA-rekisterin bitin 14. Jos Disable-rutiinia on kut- 
suttu useita kertoja, on Enable-rutiinia kutsuttava yhtä monta kertaa ennen kuin 
keskeytykset jälleen sallitaan. 


68 


Kirjastot Exec-kirjasto 


Tulos: Keskeytyspyynnöt sallitaan. 
FORBID 

Kutsu: Forbid() 

Parametrit: - 


Toiminta: Forbid-rutiini kieltää ns. tehtävän vaihdon eli muiden ohjelmien 
ajamisen. Tällöin kaikki muut koneessa pyörivät ohjelmat pysähtyvät, kunnes 
kutsutaan Wait-rutiinia(tai joitakin Intuition-kirjaston rutiineja). Forbid-rutiinia 
käytetään haluttaessa lukea sellaisia käyttöjärjestelmän tietoja, joita jokin muu 
ohjelma saattaisi muuttaa kesken lukemisen. Jos Forbid-rutiinia kutsutaan useita 
kertoja, tehtävän vaihto sallitaan vasta, kun Permit-rutiinia on kutsuttu yhtä mon- 
ta kertaa. 


Tulos: Tehtävän vaihto kielletään. 
FREEMEM 
Nimi: FreeMem -- vapauttaa AllocAbs- tai AllocMem-rutiinilla varatun 


muistialueen käyttöjärjestelmän vapaan muistin listaan 

Kutsu: FreeMem (D0,A1) 

Parametrit: DO = vapautettavien tavujen lukumäärä; A1 = vapautettavan muis- 
tin alkuosoite 

Toiminta: FreeMen-rutiini vapauttaa annetusta osoitteesta alkavan, DO tavua 
pitkän muistialueen käyttöjärjestelmälle, jolloin se voidaan jälleen varata käyttä- 
en AllocAbs- ja AllocMem-rutiineja. Muistia saa vapauttaa vain siltä alueelta, 
jolta ohjelma on sitä varannut. Ohjelman lopussa on kaikki sen varaama muisti 
vapautettava, tai käyttöjärjestelmä ei pysty käyttämään ko. muistia ilman ko- 
neen kylmäkäynnistystä. 


Tulos: Muisti vapautuu 
GETMSG 
Nimi: GetMsg -- ottaa saapuneen viestin portista 


Kutsu: DO = GetMsg (A0) 

Parametrit: AO = portti, josta viesti luetaan 

Toiminta: GetMsg lukee porttiin saapuneen viestin. Tavallisesti viestiä odote- 
taan Wait-rutiinilla, jonka jälkeen viesti vastaanotetaan GetMsg-rutiinilla. Tämä 
rutiini palauttaa ensimmäisen viestin structuren alkuosoitteen. Jos portissa ei ol- 
lut viestejä, rutiini palauttaa arvon nolla. Kun viestissä olevat tiedot on käsitel- 
ty(eli niitä ei enää tarvita), tulee viestiin vastata ReplyMsg-rutiinia käyttäen. Täl- 
löin viestin lähettänyt ohjelma saa tiedon viestin perillemenosta ja vapauttaa 
viestin vaatiman muistitilan. Yleensä kannattaa kopioida omiin muuttujiinsa 
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viestin sisältämät tarpeelliset tiedot ja vastata viestiin välittömästi. Näin estetään 
viestien kasautuminen muistiin hitaan vastaamisen seurauksena. GetMsg-rutii- 
nin käyttö selviää kirjan lopussa olevasta esimerkkiohjelmasta. 


Tulos: DO = ensimmäisen viestin structuren alkuosoite 
OPENLIBRARY 
Nimi: OpenLibrary -- avaa halutun kirjaston käyttöä varten 


Kutsu: OpenLibrary (A1, DO) 

Parametrit: A1 =kirjaston nimen osoitin; DO = vanhin hyväksyttävä kirjasto- 
versio 

Toiminta: OpenLibrary avaa annetun nimisen kirjaston, jotta siinä olevia ru- 
tiineja voidaan kutsua. Rutiinille annetaan kirjaston nimen osoitin ja haluttu ver- 
sionumero. Versionumeron avulla voidaan vaatia, että avattava kirjasto on vä- 
hintään tietty versio. Tästä on hyötyä käytettäessä sellaisia rutiineja, joita ei van- 
himmissa käyttöjärjestelmäversioissa ole. Tavallisesti kuitenkin annetaan ver- 
sionumeroksi nolla, jolloin mikä tahansa käyttöjärjestelmäversio kelpaa. 

Jos avattava kirjasto on ns. disk-resident-tyyppinen, se yritetään ladata levyk- 
keeltä, jolla kone käynnistettiin. Jos kirjasto oli jo ennestään muistissa, ei sitä la- 
data. 

Exec-kirjastoa ei tarvitse(eikä voi) avata, vaan sen perusosoite voidaan lukea 
osoitteesta $0004. 

OpenLibrary antaa D0:ssa avatun kirjaston perusosoitteen, johon lisätään ha- 
lutun rutiinin offset-arvo sitä kutsuttaessa. Jos DO = 0, ei kirjastoa voitu avata. 

Eri kirjastojen nimet löytyvät käyttöjärjestelmän kutsumista esittelevästä osas- 
ta. 


Tulos: DO = avatun kirjaston perusosoite 
PERMIT 

Kutsu: Permit() 

Parametrit: - 


Toiminta: Permit sallii jälleen tehtävän vaihdon eli muiden ohjelmien ajami- 
sen. Permit-rutiinia on kutsuttava yhtä monta kertaa kuin Forbid-rutiinia kutsut- 
tiin ennen tehtävän vaihdon uudelleen sallimista. 


Tulos: Tehtävän vaihto sallitaan(tai sitten ei). 
REMINTSERVER 
Nimi: RemlntServer -- poistaa systeemistä käyttäjän keskeytysrutiinin 


Kutsu: RemlntServer (DO[0-4], A1) 
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Parametrit: DO = Paula-piirin keskeytysbitin numero; A1 = Interrupt-structu- 
ren osoite 

Toiminta: RemlntServer poistaa systeemin listasta siihen AddIntServer-ru- 
tiinilla lisätyn keskeytysrutiinin. Katso myös AddlntServer. 


REPLYMSG 

Nimi: ReplyMsg -- vastaa saapuneeseen viestiin 

Kutsu: ReplyMsg (A 1) 

Parametrit: A1 = portti, johon viesti saapui 

Toiminta: ReplyMsg vastaa porttiin saapuneeseen viestiin. Vastaaminen tie- 
dottaa viestin lähettäneelle ohjelmalle, että viestiin liittyvät tiedot on vastaan- 
otettu ja viesti voidaan poistaa muistista. ReplyMsg-rutiinia kutsutaan GetMsg- 
kutsun jälkeen. Kirjan lopussa olevassa esimerkkiohjelmassa näytetään, miten 
vastaaminen tapahtuu käytännössä. 


WAIT 

Nimi: Wait -- odottaa viestiä 

Kutsu: Wait (DO) 

Parametrit: DO =odotettavat signaalit(jokainen bitti vastaa tiettyä signaalia) 

Toiminta: Wait odottaa, kunnes sitä kutsuneelle ohjelmalle tulee jokin viesti, 
jonka odottamista halutaan. Viestin saapumiseen saakka ohjelma on pysähdyk- 
sissä ja prosessori on vapaa ajamaan muita ohjelmia. Wait-rutiinin avulla voi- 
daan odottaa esimerkiksi näppäimien painalluksia, valikoiden käyttöä tai toisten 
ohjelmien lähettämiä viestejä. Kirjan lopussa olevassa esimerkkiohjelmassa 
Wait-rutiinilla odotetaan nappäimien painalluksia ja ikkunan sulkunappulan pai- 
namista. Esimerkki havainnollistaa Wait-rutiinin käyttöä. 

Kun Wait-rutiinista poistutaan, tulee käyttäjän ohjelman lukea saapunut viesti 
GetMsg-rutiinilla, käsitellä tiedot(mikäli se on tarpeen) sekä vastata viestiin 
ReplyMsg- rutiinilla. Jos viesteihin ei vastata, ne jäävät muistiin kuluttaen siten 
koneen vapaata muistia nopeasti. 

Tulos: DO = saapuneen signaalin bitti 
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Graphics-kirjasto 


Graphics-kirjasto sisältää grafiikan tuottamiseen liittyviä rutiineja, kuten Mo- 
ve, Draw ja Text sekä animaatiorutiinit. Lisäksi tähän kirjastoon kuuluu mm. 
monipuolinen ja tehokas BItBitMap-niminen rutiini, jonka avulla on mahdollis- 
ta kopioida ja muokata suorakulmaisia alueita näytöllä. 

Useimmat grafiikkarutiinit piirtävät APen-kynän värillä ja huomioivat piirto- 
moodin, jonka voi asettaa SetDrMd-rutiinia käyttäen. 

Graphics-kirjasto on avattava Exec-kirjaston OpenLibrary-rutiinilla ennen sii- 
nä olevien rutiinien käyttöä. Koska Graphics-kirjasto sijaitsee KickStart-ROMis- 
sa, sitä ei tarvitse ladata levykkeeltä ensi kertaa avattaessa. 

Seuraavassa esitellään lähemmin Graphics-kirjaston perusrutiineja. 


BLTBITMAP 

Nimi: BItBitMap -- kopioi suorakulmaisia alueita näytöllä 

Kutsu: DO = BItBitMap(A0,D0,D1,A1,D2,03,D4,D5,D6,D7,A2) 

Parametrit: AO = Lähde-BitMap-structuren osoite (näytön Screen-structuren 
osoite + 184); DO = Lähdesuorakulmion yläkulman x-koordinaatti; D1 = Läh- 
desuorakulmion yläkulman y-koordinaatti; A1 = Kohde-BitMap-structuren osoi- 
te(näytön Screen- structuren osoite + 184); D2 = Siirrettävän suorakulmion x- 
koordinaatti kohteessa; D3 = Siirrettävän suorakulmion y-koordinaatti kohtees- 
sa; D4 = Kopioitavan suorakulmion x-koko; D5 = Kopioitavan suorakulmion y- 
koko; D6 = Kohdesuorakulmiolle tapahtuva muunnos(minterm); D7 = Siirrettä- 
vät bittitasot(mask); A2 = Puskurimuistin alkuosoite 

Toiminta: BltBitMap-rutiini siirtää suorakulmaisen alueen bittikartasta toi- 
seen. Lähde- ja kohdebittikartat ilmoitetaan BitMap-structureiden avulla. Halut- 
taessa lähde ja kohde voivat olla sama bittikartta. Siirtoon käytetään blitteriä, jo- 
ten siirtotapahtuma on erittäin nopea. Siirrettävän alueen koordinaatit määrätään 
DO:lla ja D1:llä. Kohta, johon alue siirretään, ilmoitetaan D2:ssa ja D3:ssa, alu- 
een koko määrätään D4:llä ja D5:llä. Lähde- ja kohdebittikarttojen BitMap- 
structureiden osoitteet annetaan rutiinille AO:ssa ja A1:ssä. Koska siirron suorit- 
taa blitter, voidaan alueelle suorittaa haluttu looginen operaatio siirtonopeuden 
kärsimättä. Looginen operaatio määrätään rekisterin D6 arvolla(ns. minterm, ks. 
taulukko). Haluttaessa voidaan käsitellä vain tiettyjä bittitasoja kuvasta. Rekiste- 
rin D7 alimmat bitit vastaavat kukin yhtä bittitasoa. Jos bitti on nolla, vastaaval- 
le tasolle ei tehdä mitään. Siten arvo $ff vaikuttaa kaikkiin bittitasoihin. Jos siir- 
to tapahtuu saman bittikartan sisällä vaakasuoraan siten, että lähde- ja kohdealu- 
eet ovat osittainkin päällekkäin, BItBitMap tarvitsee CHIP-RAM-muistissa ole- 
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van puskurin, johon sopii yksi vaakapikselirivi. Puskurimuistin alkuosoite anne- 
taan rekisterissä A2. Vaakaresoluutiolla 640 tarvittavan puskurin koko on 640/8 
= 80 tavua. 

minterm = toiminta 


sfo täyttää kohdealueen ykkösillä(ei huomioi lähdettä) 

$0a tyhjentää kohdealueen(ei huomioi lähdettä) 

$50 muuttaa kohdealueen käänteiseksi(ei huomioi lähdettä) 

$c0 siirtää lähteen kohteeseen sellaisenaan 

$30 siirtää lähteen kohteeseen käänteisenä 

$ee muodostaa lähteen ja kohteen välillä TAI-toiminnon 

$88 muodostaa lähteen ja kohteen välillä JA-toiminnon 

$66 muodostaa lähteen ja kohteen välillä ETAI- toiminnon 

$22 muodostaa käänteisen lähteen ja kohteen välillä JA-toiminnon 


(nollaa kohteen bitit, jotka lähteessä ovat ykkösiä) 
Minterm-arvoja on yhteensä 256. Muut arvot voidaan laskea Hardware Refe- 
rence Manual -kirjassa sivuilla 174...177 esitetyllä tavalla. 
BItBitMap ei tarkista, että annetut alueet ovat bittikarttojen sisällä. Siksi ru- 
tiinilla on mahdollista sotkea muistia näyttöalueen ulkopuolella. 


Tulos: DO sisältää käsiteltyjen bittitasojen lukumäärän. 
BLTBITMAPRASTPORT 
Nimi: BItBitMapRastPort -- kopioi alueen bittikartasta toiseen 


Kutsu: DO = BItBitMapRastPort (A0,D0,D 1,A1,D2,D3,D4,D5,D6) 

Parametrit: AO = Lähde-BitMap-structuren osoite(esimerkiksi näytön Screen- 
structuren osoite + 184); DO = Lähdesuorakulmion vasemman yläkulman x- 
koordinaatti; D1 = Lähdesuorakulmion vasemman yläkulman y-koordinaatti; 
A1 = Kohde-RastPort-structuren osoite; D2 = Siirrettävän suorakulmion x-koor- 
dinaati kohdebittikartassa; D3 = Siirrettävän suorakulmion y-koordinaatti kohde- 
bittikartassa; D4 = Kopioitavan suorakulmion x-koko pikseleinä; D5 = Kopioita- 
van suorakulmion y-koko pikseleinä; D6 = Suorakulmiolle siirron aikana tehtä- 
vä operaatio(minterm) 

Toiminta: BltBitMapRastPort-rutiini vastaa muuten BltBitMap-rutiinia, mut- 
ta kohteena on RastPort-structuren ilmaisema bittikartta BitMap-structuren il- 
maiseman alueen sijasta. BItBitMapRastPort-rutiinin yhteydessä ei mask-tietoa 
ole käytettävissä, vaan kaikki RastPort-structuren ilmaisemat bittitasot ovat toi- 
minnassa mukana. Minterm-arvo määrää siirrettävälle alueelle siirron aikana 
suoritettavan loogisen operaation, ks. BItBitMap. DO ilmaisee siirron onnistumi- 
sen (DO = O, jos siirto epäonnistui). 


73 


Kirjastot Graphics-kirjasto 


CLEAREOL 


Nimi: ClearEOL -- tyhjentää piirtokynän paikasta rivin loppuun 

Kutsu: ClearEOL(A 1) 

Parametrit: Al = Näytön Rastport-structuren osoite 

Toiminta: ClearEOL-rutiini tyhjentää näytössä suorakulmaisen alueen piirto- 
kynän paikasta näytön oikeaan reunaan saakka. Alueen korkeus riippuu käytös- 
sä olevasta tekstifontista. 


CLEARSCREEN 


Nimi: ClearScreen -- tyhjentää halutun näytön 

Kutsu: ClearScreen(A 1) 

Parametrit: A1 = Näytön Rastport-structuren osoite 

Toiminta: ClearScreen-rutiini tyhjentää halutun näytön piirtokynän paikasta 
alaspäin. Aluksi tyhjennetään yhden tekstirivin korkuinen alue piirtokynästä oi- 
kealle reunaan saakka. Sitten tyhjennetään näytön alaosa ko. tekstirivin alapuo- 
lelta alareunaan saakka. 


CLIPBLIT 

Nimi: ClipBlit -- kopioi suorakulmaisia alueita näytöllä 

Kutsu: ClipBlit(A0,D0,D1,A 1,D2,D3,D4,D5,D6) 

Parametrit: AO = Lähde-Rastport-structuren osoite(ikkunan Window- structu- 
ren osoite + 50 sisältää Rastportin osoitteen); DO = Lähdesuorakulmion yläkul- 
man x-koordinaatti; D1 = Lähdesuorakulmion yläkulman y-koordinaatti: A1 = 
Kohde-Rastport-structuren osoite(ikkunan Window-structuren osoite + 50 sisäl- 
tää Rastportin osoitteen;. D2 = Siirrettävän suorakulmion x-koordinaatti kohtees- 
sa; D3 = Siirrettävän suorakulmion y-koordinaatti kohteessa; D4 = Kopioitavan 
suorakulmion x-koko; D5 = Kopioitavan suorakulmion y-koko; D6 = Koh- 
desuorakulmiolle tapahtuva muunnos(minterm) 

Toiminta: ClipBlit-rutiini siirtää suorakulmaisen alueen bittikartasta toiseen. 
Lähde- ja kohdebittikartat ilmoitetaan Rastport-structureiden avulla. Haluttaessa 
lähde ja kohde voivat olla sama bittikartta. Siirtoon käytetään blitteriä, joten siir- 
totapahtuma on erittäin nopea. Siirrettävän alueen koordinaatit määrätään D0O:lla 
ja D1:llä. Kohta, johon alue siirretään, ilmoitetaan D2:ssa ja D3:ssa, alueen ko- 
ko määrätään D4:llä ja D5:llä. Lähde- ja kohdebittikarttojen RastPort-structurei- 
den osoitteet annetaan rutiinille A0:ssa ja A1:ssä. Koska siirron suorittaa blitter, 
voidaan alueelle suorittaa haluttu looginen operaatio siirtonopeuden kärsimättä. 
Looginen operaatio määrätään rekisterin D6 arvolla(ns. minterm, ks. taulukko). 
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minterm = toiminta 


$to täyttää kohdealueen ykkösillä(ei huomioi lähdettä) 

$0a tyhjentää kohdealueen(ei huomioi lähdettä) 

$50 muuttaa kohdealueen käänteiseksi(ei huomioi lähdettä) 

$c0 siirtää lähteen kohteeseen sellaisenaan 

$30 siirtää lähteen kohteeseen käänteisenä 

See muodostaa lähteen ja kohteen välillä TAI-toiminnon 

$88 muodostaa lähteen ja kohteen välillä JA-toiminnon 

$66 muodostaa lähteen ja kohteen välillä ETAI- toiminnon 

$22 muodostaa käänteisen lähteen ja kohteen välillä JA-toiminnon 


(nollaa kohteen bitit, jotka lähteessä ovat ykkösiä) 
Minterm-arvoja on yhteensä 256. Muut arvot voidaan laskea Hardware Refe- 
rence Manual -kirjassa sivuilla 174...177 esitetyllä tavalla. 
ClipBlit vastaa muuten BItBitMap-rutiinia, mutta se tarkistaa, että siirrettävät 
alueen ovat bittikarttojen sisällä. 


CLOSEFONT 


Nimi: CloseFont -- sulkee OpenFont-rutiinilla avatun fontin 

Kutsu: CloseFont (A 1) 

Parametrit: A1 = OpenFont-rutiinilta saatu fontin osoitin 

Toiminta: CloseFont-rutiini sulkee OpenFont-rutiinilla aukaistun fontin, jol- 
loin käyttöjärjestelmä voi tarvitessaan vapauttaa niiden vaatiman muistitilan. 
Nykyinen käyttöjärjestelmä ei kuitenkaan vapauta muistia ennen kuin se on vält- 
tämätöntä. 


DRAW 

Nimi: Draw -- piirtää viivan bittikarttaan 

Kutsu: Draw (A1, D0, D1) 

Parametrit: A1 = Bittikartan määrittelevän Rastport-structuren osoite; DO = 
Viivan päätepisteen x-koordinaatti; D1 = Viivan päätepisteen y-koordinaatti 

Toiminta: Draw-rutiini piirtää viivan kynän nykyisen paikan ja annetun pis- 
teen välille. Piirtokynä siirtyy annettuihin koordinaatteihin. Katso myös Move. 


FLOOD 
Nimi: Flood -- täyttää rajatun alueen bittikartassa 
Kutsu: Flood (A1, D2, DO, D 1) 
Parametrit: 


A1 =RastPort, joka määrittelee bittikartan; D2 = Toimintamoodi: 0:Täyttää 
tietynväriseen rajaan saakka, 1:Täyttää kaikki pisteen(x,y) väriset pisteet yhte- 
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näiseltä alueelta; DO = Aloituspikselin x-koordinaatti; D1 = Aloituspikselin y- 
koordinaatti 

Toiminta: Flood täyttää rajatun alueen APen-kynän värillä. Jos moodi on nol- 
la, väritetään kaikki pikselit AOLPen-kynällä piirrettyyn rajaan saakka. Jos moo- 
di on yksi, väritetään kaikki aloituspikselin väriset, aloituspikseliin yhteydessä 
olevat pikselit. Flood vaatii toimiakseen, että Rastport-structuressa on annettu 
väliaikainen työalue, TmpRas. Alueen on sijaittava CHIP-RAM-muistissa ja sen 
minimikoko saadaan seuraavasti: koko = INT( (x + 15) / 16) * y * 2, missä x ja 
y ovat bittikartan resoluutio pikseleinä ja koko on varattavan muistialueen koko 
tavuina. Siten esimerkiksi 320 * 200 -alue vaatii muistia 8000 tavua. Flood-rutii- 
nin käytöstä on esimerkki kirjan lopussa. 


LOADRGB4 


Nimi: LoadRGB4 -- asettaa useita ViewPort-structureen kuuluvia 
värirekisterejä alkaen rekisteristä 0. 

Kutsu: LoadRGB4 (A0, A1, DO) 

Parametrit: AO = ViewPort, johon vaikutetaan; A1 = Värikartan alku; DO = 
Värikartan pituus sanoina 

Toiminta: LoadRGB4-rutiini asettaa halutun ViewPort-structuren värirekiste- 
rien arvot. Värikartassa on oltava n kappaletta 16-bittisiä lukuja, joiden 

- bitit 0...3 määräävät sinisen värin määrän(0...15) 

- bitit 8...11 määräävät punaisen värin määrän(0...15) 

- bitit 12...15 eivät vaikuta 

Rekisteri DO ilmoittaa, montako väriä taulukossa on. Tavallisesti asetetaan 
niin monta väriä kuin näytössä tarvitaan, esimerkiksi 4-bittitasoisessa näytössä 
16. 

Väritaulukko voisi olla esim. 


värit: 
dc.w $0000 : musta 
dc.w $00f0 ; kirkkaan vihreä 
dc.w $000a ; sininen 
dc.w $OffO : keltainen 
MOVE 
Nimi: Move -- siirtää kynän Rastport-structuren ilmaisemassa 


bittikartassa haluttuun paikkaan 
Kutsu: Move (A1, DO, D1) 
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Parametrit: A1 = Bittikartan määrittelevän Rastport-structuren osoite; DO = x- 
koordinaatti; D1 = y-koordinaatti 

Toiminta: Move-rutiini siirtää piirtokynän x-ja y-koordinaateilla ilmaistuun 
paikkaan. Origo (0,0) on bittikartan vasemmassa yläkulmassa, kuten kaikissa 
grafiikkarutiineissa. 


OPENFONT 


Nimi: OpenFont -- avaa muistissa olevan halutun fontin 

Kutsu: DO = OpenFont (A0) 

Parametrit: AO = TextAttr-structuren osoite 

Toiminta: OpenFont-rutiini etsii muistista TextAttr-structuren vaatimuksia lä- 
hinnä vastaavan fontin. Rutiinin palauttamaa arvoa käytetään fonttia suljettaessa 
ja asetettaessa sitä käyttöön SetFont-rutiinia. Kun fonttia ei enää käytetä, se tu- 
lee sulkea CloseFont-rutiinilla, jotta käyttöjärjestelmä voi halutessaan vapauttaa 
fontin vaatiman muistitilan. 


TextAttr structure: 

textattr: 

dc.1 nimi = ; avattavan fontin nimen osoitin 

dc.w 9 ; y-koko 

dc.b 0 ; tyyli(tummennettu, alleviivattu, 
; kursiivi) 

dc.b 0 ; liput 

nimi: 

dc.b "topaz.font" ; isompi ROM-fontti(topaz.9) 

Tulos: DO = avatun fontin osoitin. 

POLYDRAW 
Nimi: PolyDraw -- piirtää monikulmion 


Kutsu: PolyDraw (A1, DO, A0) 

Parametrit: A1 = RastPort-structure, joka määrittelee bittikartan; DO = moni- 
kulmion kulmien lukumäärä; AO = osoitin kulmapisteiden koordinaattiparitau- 
lukkoon(x- ja y-koordinaatit) 

Toiminta: PolyDraw-rutiini piirtää monikulmion annettujen kulmien koor- 
dinaattien mukaan. Koordinaattien on oltava 16-bittisiä lukuja, ensiksi x- ja sit- 
ten y-koordinaatti. Ennen PolyDraw-rutiinin kutsumista on piirtokynä asetettava 
ensimmäisen pisteeseen Move-rutiinia käyttäen. 
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READPIXEL 


Nimi: ReadPixel -- lukee RastPort-structuressa määritellyn bittikartan 
yksittäisen pikselin värin 
Kutsu: DO = ReadPixel (A1, D0, D1) 
Parametrit: A1 = RastPort, josta luetaan; DO = Pikselin x-koordinaatti: D1 = 
Pikselin y-koordinaatti 
Toiminta: ReadPixel-rutiini lukee halutusta bittikartasta pikselin värin. 


Tulos: DO = värirekisterin numero 
RECTFILL 
Nimi: RectFill -- piirtää täytetyn suorakulmion annetun Rastport- 


structuren määrittelemään bittikarttaan 

Kutsu: RectFill (A1, DO, D1, D2, D3) 

Parametrit: A1 = RastPort, johon vaikutetaan; DO = yläkulman x-koordinaat- 
ti; DI = yläkulman y-koordinaatti: D2 = alakulman x-koordinaatti; D3 = alakul- 
man y-koordinaatti 

Toiminta: RectFill-rutiini piirtää Rastport-structuressa määriteltyyn bittikart- 
taan suorakulmion käytössä olevalla piirtokynän värillä huomioideri piirtomoo- 
din. 


SCROLLRASTER 


Nimi: ScrollRaster -- vierittää suorakulmaista aluetta RastPort-structuren 

määrittelemässä bittikartassa 

Kutsu: ScrollRaster (A1, D0, D1, D2, D3, D4, D5) 

Parametrit: A1 = Rastport, joka määrittelee bittikartan; DO = vieritettävä pik- 
selimäärä x-suunnassa(positiivinen arvo vierittää vasemmalle): DI =vieritettävä 
pikselimäärä y-suunnassa (positiivinen arvo vierittää ylöspäin); D2 = siirrettä- 
vän suorakulmion vasemman yläkulman x- koordinaatti; D3 = siirrettävän suora- 
kulmion vasemman yläkulman y- koordinaatti; D4 = siirrettävän suorakulmion 
oikean alakulman x- koordinaatti; D5 = siirrettävän suorakulmion oikean alakul- 
man y- koordinaatti 

Toiminta: ScrollRaster-rutiini vierittää suorakulmaista aluetta bittikartassa ha- 
uttuun suuntaan. Jos x- tai y-suunnan pikselimäärä on nolla, alue ei liiku ao. 
suunnassa. Vierityksen vuoksi vapautuva alue tyhjenee eli muuttuu taustan 


siin suuntiin. 
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SETAPEN 


Nimi: SetAPen -- asettaa Rastport-structureen kuuluvan APen-kynän 
värin 
Kutsu: SetAPen (A 1, DO) 
Parametrit: A1 = RastPort-structuren osoite; DO = värirekisterin numero 
(0-255) 
Toiminta: SetAPen-rutiini asettaa RastPortin APen-kynän väriksi annetun vä- 
rirekisterin. Värirekisterin suurin numero riippuu näytön bittitasojen lukumääräs- 
tä(esim. 5 bittitasoa, värirekisterit 0...31). 


SETBPEN 


Nimi: SetBPen -- asettaa Rastport-structureen kuuluvan BPen-kynän 
värin 
Kutsu: SetBPen (A1, D0) 
Parametrit: A1 = RastPort-structuren osoite; DO = värirekisterin numero 
(0-255) 
Toiminta: SetBPen-rutiini asettaa RastPortin BPen-kynän väriksi annetun vä- 
rirekisterin. Värirekisterin suurin numero riippuu näytön bittitasojen lukumääräs- 
tä (esim. 5 bittitasoa, värirekisterit 0...31). 


SETDRMD 


Nimi: SetDrMd -- asettaa Rastport-structureen kuuluvan piirtomoodin 

Kutsu: SetDrMd (A1, DO) 

Parametrit: A1 = RastPort-structuren osoite; DO = moodi 

Toiminta: SetDrMd-rutiini asettaa RastPortin piirtomoodiksi jonkin allaolevi- 
en kombinaation. Piirtomoodi vaikuttaa kaikkiin grafiikkarutiineihin. Moodit on 
määritelty myös include-tiedostossa. 

Moodit: 

JAMI =O piirtää yhdellä värillä bittikarttaan 

JAM2=1 piirtää kahdella värillä 

COMPLEMENT =2 muodostaa ETAI-toiminnon vanhan tiedon ja värin 31 
välillä 

INVERSVID =4 tulostaa käänteisenä 


SETFONT 


Nimi: SetFont -- vaihtaa halutun Rastport-structuren fontin 
Kutsu: SetFont (A1, A0) 
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Parametrit: A1 = Halutun Rastport-structuren osoite; AO = OpenFont-rutiinin 
antama fontin osoite 

Toiminta: SetFont-rutiini asettaa haluttuun Rastport-structureen uuden fontin. 
Fontti on ensin avattava OpenFont- tai OpenDiskFont-rutiinia käyttäen. 


Tulos: Rastport-structureen on asetettu uusi fontti. 
SETRGB4 
Nimi: SetRGB4 -- vaihtaa ViewPort-structureen kuuluvan värirekisterin 
värin 


Kutsu: SetRGB4 (A0, D0, D1, D2, D3) 

Parametrit: AO = ViewPort, johon vaikutetaan; DO = Värirekisterin numero; 
sen värin määrä (0-15) 

Toiminta: SetRGB4-rutiini asettaa yhden ViewPort-structureen liittyvän väri- 
rekisterin värin. 


SETRAST 


Nimi: SetRast -- täyttää halutun Rastport-structuren määrittelemän 
bittikartan halutulla värillä 
Kutsu: SetRast (A1, DO) 
Parametrit: A1 = Bittikartan määrittelevän Rastport-structuren osoite: DO = 
Värirekisterin numero (0-255) 
Toiminta: SetRast-rutiini täyttää halutun Rastportin bittikartan annetun kynän 
värillä. Kynän väriä asetettaessa on D0:n ylemmät bitit(8...31) nollattava. 


TEXT 


Nimi: Text -- tulostaa käytössä olevalla fontilla tekstiä haluttuun 
bittikarttaan. 

Kutsu: Text (A1, AO, D0) 

Parametrit: A1 = Bittikarttaan liittyvän Rastport-structuren osoite: AO = 
Merkkijonon alkuosoite; DO = Merkkijonon pituus merkkeinä 

Toiminta: Rutiini tulostaa kyseisessä Rastport-structuressa ilmoitetulla fontil- 
la merkkijonon merkit bittikarttaan valittua piirtotapaa noudattaen. Tulostus aloi- 
tetaan nykyisestä piirtokynän paikasta. Piirtokynän y-koordinaatti tulee merkki- 
en perusviivan tasoksi. Ikkunaan tulostettaessa ikkunan laitojen ulkopuolelle me- 
neviä merkkejä ei tulosteta. 

Tulos: Teksti tulostuu näytölle käytössä olevalla APen-kynän värillä (ja 
BPen-värillä, jos moodi on JAM2). 
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TEXTLENGTH 


Nimi: TextLength -- laskee halutun merkkijonon pituuden pikseleinä 

Kutsu: DO = TextLength (A1, AO, DO) 

Parametrit: A1 = Bittikarttaan liittyvän Rastport-structuren osoite; AO = 
Merkkijonon alkuosoite; DO = Merkkijonon pituus merkkeinä 

Toiminta: TextLength-rutiini palauttaa annetun merkkijonon pituuden pikse- 
leiksi muutettuna huomioiden Rastport-structuressa ilmoitetun fontin. 

Tulos: DO = merkkijonon pituus pikseleinä 


VBEAMPOS 


Nimi: VBeamPos -- lukee elektronisuihkun nykyisen paikan 

Kutsu: VBeamPos() 

Parametrit: - 

Toiminta: VBeamPos-rutiini palauttaa käyttäjälle elektronisuihkun nykyisen 
pystykoordinaatin. Amigan kovosta johtuen elektronisuihkun ollessa rivillä 256 
tai sen alapuolella rutiini palauttaa arvon, josta on vähennetty 256. Koordinaatti 
ei vastaa suoraan näytöllä näkyviä koordinaatteja, vaan siitä on ensin vähennet- 
tävä näytön paikasta riippuva luku. 

Tulos: DO-rekisterissä on elektronisuihkun pystykoordinaatti rutiinin 
ajohetkellä. Moniajosta johtuen saattaa elektronisuihku olla jo alempana koneen 
palatessa käyttäjän ohjelmaan. 


WAITBOVP 


Nimi: WaitBOVP --odottaa, kunnes elektronisuihku on saavuttanut 
annetun ViewPortin alalaidan 

Kutsu: WaitBOVP (A0) 

Parametrit: AO = ViewPort-structuren alkuosoite 

Toiminta: WaitBOVP-rutiini odottaa, kunnes monitorin elektronisuihku on 
ViewPort-structuren määrittelemän ViewPortin(esimerkiksi näyttö) alapuolella. 
Rutiinia voidaan käyttää haluttaessa tahdistaa piirtotapahtuma monitorin elekt- 
ronisuihkuun. Tämä saa näytöllä tapahtuvan liikkeen näyttämään tasaiselta. Mo- 
niajo saattaa kuitenkin aiheuttaa sen, että prosessori on suorittamassa jotakin 
muuta ohjelmaa sillä hetkellä, kun elektronisuihku on ViewPortin alalaidassa. 


WAITTOF 


Nimi: WaitTOF -- odottaa, kunnes elektronisuihku on kuvaruudun 
ylälaidassa 
Kutsu: WaitTOF() 
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Parametrit: - 

Toiminta: WaitTOF-rutiini odottaa, kunnes elektronisuihku on kuvaruudun 
ylälaidassa. Sitä voidaan käyttää haluttaessa tahdistaa piirtotapahtuma monitorin 
elektronisuihkuun. Tämä saa näytöllä tapahtuvan liikkeen näyttämään tasaiselta. 
Moniajo saattaa kuitenkin aiheuttaa sen, että prosessori on suorittamassa jotakin 
muuta ohjelmaa sillä hetkellä, kun elektronisuihku on näytön ylälaidassa. 


WRITEPIXEL 


Nimi: WritePixel -- vaihtaa RastPort-structuressa määritellyn bittikartan 
yksittäisen pikselin väriä 
Kutsu: WritePixel (A1, DO, D1) 
Parametrit: A1 = RastPort, johon vaikutetaan; DO = Pikselin x-koordinaatti; 
D1 = Pikselin y-koordinaatti 
Toiminta: WritePixel-rutiini asettaa halutussa bittikartassa pikselin värin tä- 
mänhetkisen APen-kynän ja piirtomoodin mukaisesti. 


Intuition-kirjasto 


Intuition-kirjasto sisältää Amigan graafisen käyttöjärjestelmän ohjausrutiinit. 
Näiden avulla ohjataan mm. näyttöjä, ikkunoita ja valikoita. Intuition-kirjasto 
on avattava Exec-kirjaston OpenLibrary-rutiinilla ennen siinä olevien rutiinien 
käyttöä. Intuition-kirjasto kuuluu osana KickStart-ROMiin, joten sitä ei tarvitse 
ladata levykkeeltä ensi kertaa avattaessa. 

Seuraavassa esitellään lähemmin Intuition-kirjaston eniten käytettyjä rutiine- 
ja. 


CLOSESCREEN 


Nimi: CloseScreen -- sulkee näytön 

Kutsu: CloseScreen (A0) 

Parametrit: AO = osoitin suljettavan näytön Screen-structureen 

Toiminta: CloseScreen-rutiinille annetaan A0:ssa OpenScreen-rutiinilta saatu 
osoitin. CloseScreen sulkee näytön eli poistaa sen kuvaruudusta ja vapauttaa sen 
vaatiman muistin. Ennen CloseScreen-rutiinin kutsumista on suljettava kaikki 
näytössä mahdollisesti olleet ikkunat. 

Jos suljettava näyttö oli kuvaruudun viimeinen, rutiini avaa Workbench-näy- 
tön. Jos näyttö ei ollut auki, kone sekoaa. 

Tulos: Näyttö sulkeutuu. 
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CLOSEWINDOW 


Nimi: CloseWindow -- sulkee ikkunan 

Kutsu: CloseWindow (A0) 

Parametrit: AO = osoitin suljettavan ikkunan Window-structureen 

Toiminta: CloseWindow-rutiinille annetaan AO:ssa Open Window-rutiinilta 
saatu osoitin. CloseWindow sulkee ikkunan eli poistaa sen kuvaruudusta ja va- 
pauttaa sen vaatiman muistin. Ennen CloseWindow-rutiinin kutsumista on pois- 
tettava kaikki ikkunaan mahdollisesti kuuluvat valikot. Jos ikkuna ei ollut auki, 
kone sekoaa. 


Tulos: Ikkuna sulkeutuu. 
DISPLAYALERT 
Nimi: DisplayAlert -- näyttää alert-laatikon 


Kutsu: DisplayAlert (DO, A0, D1) 

Parametrit: DO = alertin numero ja tyyppi; AO = alertin merkkijono-osoitin; 
DI = alert-laatikon korkeus 

Alertin merkkijono muodostuu varsinaisen ASCII-merkkijonon lisäksi x- ja y- 
koordinaateista ja jonon loppua ilmaisevasta tavusta. Merkkijonon alussa on 
tekstin 16-bittinen x- koordinaatti ja 8-bittinen y-koordinaatti, joiden jälkeen 
seuraa varsinainen teksti ASCII-merkkeinä. Tekstin on päätyttävä nollatavuun. 
Nollan jälkeen seuraava tavu ilmoittaa, kuuluuko alerttiin useampia rivejä teks- 
tiä: Jos tavu on nolla, ei teksti jatku. Muussa tapauksessa seuraa jälleen x-koor- 
dinaatti, y-koordinaatti, teksti, nolla, jatkuvuutta ilmaiseva tavu jne. 

Merkkijono: 


dc.w 20 ;x-koordinaatti dc.b 16 sy-koordinaatti 
dc.b "Ensimmäinen tekstirivi”,0 

dc.b 1 steksti jatkuu... 

dc.w 20 ;x-koordinaatti dc.b26 sy-koordinaatti 
dc.b "Toinen tekstirivi”,0 

dc.b 0 teksti ei jatku! 


Toiminta: DO-rekisterin arvo määrää alert-laatikkoon tulostettavan luvun. 
Käyttöjärjestelmän kannalta vain ylin bitti on merkitsevä. Include-tiedostossa 
tyyppi on määritelty seuraavasti: 

RECOVERY ALERT = $00000000— (jatkaminen mahdollista) 

DEADEND ALERT = $80000000 (seuraa RESET) 

A0O-rekisteriin tulee asettaa yllä olevan merkkijonon alkuosoite. D1:n arvo 
määrää alert-ikkunan korkeuden pikseleinä. Alert-rutiini palauttaa DO:ssa tiedon 
siitä, kumpaako hiiren nappulaa käyttäjä painoi. Nolla vastaa oikeanpuoleista, 
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muu arvo vasemman puoleista nappulaa. Jos alertin tyyppi oli DEA- 
DEND ALERT, rutiini palauttaa aina arvon nolla riippumatta painetusta hiiren 
nappulasta. 

Alert-ikkuna vastaa käyttöjärjestelmän guru-ilmoituksia. 

Tulos: Kuvaruudun yläreunaan avataan alert-ikkuna, josta voi poistua 
painamalla hiiren nappia. Käyttäjän painettua hiiren nappulaa palataan takaisin, 
jolloin DO sisältää tiedon painetusta nappulasta. 


DISPLAYBEEP 

Nimi: DisplayBeep -- väläyttää haluttua näyttöä erivärisenä 

Kutsu: DisplayBeep (A0) 

Parametrit: AO = Näytön Screen-structuren osoite 

Toiminta: Valitun näytön taustan väri(väri nolla) välähtää lyhyen aikaa eri 
värisenä. Tätä voidaan käyttää kiinnittämään käyttäjän huomio esimerkiksi vir- 
heellisen käskyn seurauksena. Jos AO =O, väläytetään kaikkia näyttöjä. 


Tulos: Näytön taustan väri välähtää eri värisenä. 
GETDEFPREFS 
Nimi: GetDefPrefs -- lukee muistista Preferences-oletusarvot 


Kutsu: GetDefPrefs (AO, DO) 

Parametrit: AO = Preferences-structurelle varatun muistialueen alkuosoite: 
DO = muistialueen koko tavuina 

Toiminta: GetDefPrefs-rutiinilla luetaan muistista tehtaalla ROM-muistiin 
asetetut Preferences-oletusarvot. Sen jälkeen ohjelma voi muuttaa haluamiaan 
parametreja structuressa ja asettaa uudet arvot käyttöön SetPrefs-rutiinilla. Prefe- 
rences-structuren listaus löytyy include-tiedostosta. Eri arvojen vaikutuksia on 
helppo kokeilla Preferences- ohjelman avulla. 


Tulos: Preferences-oletusarvot tallentuvat niille varatulle muistialueelle. 
GETPREFS 
Nimi: GetPrefs -- lukee muistista käytössä olevat preferences-asetukset 


Kutsu: GetPrefs (A0, D0) 

Parametrit: AO = Preferences-structurelle varatun muistialueen alkuosoite:; 
DO = muistialueen koko tavuina 

Toiminta: GetDefPrefs-rutiinilla luetaan muistista käytössä olevat Preferen- 
ces-asetukset. Sen jälkeen ohjelma voi muuttaa haluamiaan parametreja structu- 
ressa ja asettaa uudet arvot käyttöön SetPrefs-rutiinilla. Preferences-structuren 
listaus löytyy include-tiedostosta. Eri arvojen vaikutuksia on helppo kokeilla 
Preferences-ohjelman avulla. 
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Tulos: Käytössä olevat Preferences-asetukset tallentuvat niille varatulle 
muistialueelle. 
MOVESCREEN 

Nimi: MoveScreen -- siirtää näyttöä pystysuunnassa tietyn pikselimäärän 


Kutsu: MoveScreen (A0, D0, D1) 

Parametrit: AO = näytön Screen-structuren osoite; DO = x-suunnan pikseli- 

Toiminta: MoveScreen-rutiini siirtää haluttua näyttöä annetun pikselimäärän 
joko ylös- tai alaspäin. Jos DI on negatiivinen, näyttö liikkuu ylöspäin, jos taas 
positiivinen, alaspäin. Nykyinen käyttöjärjestelmä ei mahdollista näyttöjen lii- 
kuttamista vaakasuunnassa. Jos näyttöä ei voida liikuttaa D1:n ilmaisemaa mää- 
rää (esimerkiksi ulos kuvaruudun yläreunasta), se liikkuu vain ylä- tai alarajaan 
saakka. 


Tulos: Näyttö liikkuu D1:ssä annetun pikselimäärän ylös tai alas. 
MOVEWINDOW 
Nimi: MoveWindow -- siirtää ikkunaa x- ja/tai y-suunnassa halutun 
pikselimäärän 


Kutsu: MoveWindow (AO, D0, D1) 
Parametrit: AO = ikkunan Window-structuren osoite; DO = x-suunnan pikseli- 


ylös, positiivisilla oikealle ja alas. Jos DO tai D1 on nolla, ikkuna pysyy vastaa- 
vassa suunnassa paikallaan. Ikkuna siirtyy vasta, kun Intuition vastaanottaa seu- 
raavan viestin (tämä tapahtuu vähintään kymmenen kertaa sekunnissa). 

Rutiini ei tarkista DO:n ja D1:n arvojen järkevyyttä. Jos ikkuna yritetään siir- 
tää näytön ulkopuolelle, kone sekoaa. 

Tulos: Ikkuna liikkuu DO- ja D1-rekistereissä annetun pikselimäärän x- 
ja y-suunnissa. 


OPENSCREEN 


Nimi: OpenScreen -- avaa uuden näytön 

Kutsu: D0 =OpenScreen (A0) 

Parametrit: AO = NewScreen-structuren osoite 

Toiminta: OpenScreen-rutiini avaa uuden näytön, jonka ominaisuudet on ase- 
tettu NewScreen-structureen. Structure ja näyttöihin liittyvät vakiot (resoluutio 
yms.) on määritelty include-tiedostossa. Rutiini palauttaa osoittimen avatun näy- 
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tön Screen-structureen. Osoitinta tarvitaan kaikkien näyttöön liittyvien toiminto- 
jen yhteydessä. 

Alla malli NewScreen-structuresta: 

NewScreen: dc.w0; näytön vas. yläkulman x-koordinaatti 


dc.w 0) ; näytön vas. yläkulman y-koordinaatti 

dc.w 320 — ; näytön x-koko 

dc.w 256 — ; näytön y-koko 

dc.w 5 ; näytössä olevien bittitasojen määrä 

dc.b 0) ; otsikkopalkin väri 1 

dc.b 1 ; otsikkopalkin väri 2 

dc.w 0 ; moodi(tässä LORES (320 x 256)) 

dc.w 15 ; näytön tyyppi(yleensä CustomScreen, kuten 
; tässä) 

dc.1 0 ; käytettävät fontit(tässä normaalit) 

dc.1 nimi =; näytön nimen osoitin 

dc.1 0 ; ensimmäisen gadgetin osoitin(tässä ei 
; gadgetteja) 

dc.1 0 ; osoitin käyttäjän määrittelemään BitMap- 
; structureen, tässä ei käytössä 
nimi: 

dc.b *Oma Näyttö!!! 0 


Näytön erottelukyky eli resoluutio voidaan valita seuraavasta. Taulukossa on 


32. HAM käyttää kuutta bittitasoa. 


tila resoluutio — värejä moodi 
LORES 320 x 256 2:30, $0000 
HIRES 640 x 256 2...16 $8000 
LORES+LACE 320x 512 22.32 $0004 
HIRES+LACE 640 x 512 — 2...16 $8004 
LORES+HAM 320 x 256 = 409 $0800 
LORES+LACE+HAM 320x512 = 4096 $0804 


Useat grafiikkarutiinit tarvitsevat parametrikseen näyttöön liittyviä tietoja, ku- 
ten RastPort-, ViewPort- tai BitMap-structuren osoitteen. Nämä structuret kuulu- 
vat kaikki osana Screen-structureen, jonka osoittimen OpenScreen palauttaa DO- 
rekisterissä. Niiden osoite saadaan joko include-tiedostossa määriteltyjä vakioita 
käyttäen tai suoraan lisäämällä Screen-structuren alkuosoitteeseen seuraavat ar- 
vot: 
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Screen-structure + 44 = Viewport-structure Screen-structure + 84 = Rastport- 
structure Screen-structure + 184 = Bitmap-structure 

Kun tunnetaan BitMap-structuren alkuosoite, saadaan selville yksittäisten bit- 
titasojen osoittimet. Niitä ei tarvita käyttöjärjestelmän grafiikkarutiineja käytettä- 
essä, mutta niistä on hyötyä haluttaessa kirjoittaa prosessorilla tietoa suoraan 
näyttömuistiin. 

BitMap-structure + 8 = Ensimmäisen bittitason osoite BitMap-structure + 12 
= Toisen bittitason osoite 

BitMap-structure + 16 = Kolmannen bittitason osoite BitMap-structure + 20 
= Neljännen bittitason osoite 

BitMap-structure + 24 = Viidennen bittitason osoite 

BitMap-structure + 28 = Kuudennen bittitason osoite 

BitMap-structure + 32 = Seitsemännen bittitason osoite * 

BitMap-structure + 36 = Kahdeksannen bittitason osoite * 

*)kaksi viimeistä bittitasoa eivät ole koskaan käytössä A500-, A1000- ja 
A2000-malleissa. 

Tulos: Kuvaruutuun avautuu uusi näyttö ja DO:ssa on osoitin näytön tiedot si- 
sältävän Screen-structuren alkuun. Tätä osoitinta tarvitaan mm. näyttöä suljetta- 
essa. Jos näytön avaaminen ei onnistunut(muisti ei riitä tms.), DO:n arvo on nol- 
la. 


— 


OPENWINDOW 


Nimi: Open Window -- avaa uuden ikkunan 

Kutsu: D0 = OpenWindow (A0) 

Parametrit: AO = New Window-structuren osoite 

Toiminta: OpenWindow-rutiini avaa uuden näytön, jonka ominaisuudet on 
asetettu New Window-structureen. Structure ja ikkunoihin liittyvät vakiot (koko, 
gadgetit yms.) on määritelty include-tiedostossa. Rutiini palauttaa osoittimen 
avatun ikkunan Window-structureen. Osoitinta tarvitaan kaikkien ikkunaan liit- 
tyvien toimintojen yhteydessä. 

Alla malli NewWindow-structuresta: 


NewWindow: 

dc.w 0 ; ikkunan vas. yläkulman x-koordinaatti 
dc.w 0 ; ikkunan vas. yläkulman y-koordinaatti 
dc.w 220 — ; ikkunan x-koko 

dc.w 156 —; ikkunan y-koko 

dc.b 0 ; otsikkopalkin väri 1 

dc.b 1 ; otsikkopalkin väri 2 

dc.1 0 ; IDCMP-liput 
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dc.1 0 ; liput 

dc.] o ; osoitin ensimmäiseen gadget-structureen 
dc.1 0 ; osoitin valintamerkkiin 

dc.1 nimi = ; osoitin ikkunan nimeen 

dc.1 ikk ; osoitin näytön Screen-structureen 
dc.1 0 ; osoitin omaan BitMap-structureen 
dc.w 100 — ; pienin sallittu x-koko 

dc.w 90 ; pienin sallittu y-koko 

dc.w 320 — ; suurin sallittu x-koko 

dc.w 256 — ; suurin sallittu y-koko 

dc.w 15 ; tyyppi(CUSTOM) 

nimi: 


dc.b *Oma Ikkuna!!!?,0 
Ennen ikkunan avaamista on oltava tiedossa sen näytön Screen-structuren 
osoite, johon ikkuna halutaan avata. Osoite on tallennettava New Window-struc- 
tureen ao. paikkaan (ikk). Avattavalle ikkunalle tulee sama resoluutio ja värien 
määrä kuin näytöllä, johon ikkuna avataan. Structuren lopussa olevat x- ja y- 
* kunan kokoa hiiren avulla, nämä arvot rajoittavat koon halutuksi. 
Ikkunaan tulevat gadgetit (koon säätämis-, siirtämis-, sulkemis- jne.) saadaan 
"käyttöön asettamalla vastaavat bitit liput-muuttujassa. Bitit löytyvät include-tie- 
dostosta. Muutamien bittien merkitykset: 


WINDOWSIZING koon säätämisgadget 
WINDOWDRAG siirtämisgadget(otsikkopalkki) 
WINDOWDEPTH eteen/taakse-gadgetit 
WINDOWCLOSE sulkunappula 

BORDERLESS reunaton ikkuna 

ACTIVATE ikkuna aktivoituu avattaessa 


IDCMP-liput määräävät, mitä ikkunaan liittyvää syöttötietoa ohjelmalle väli- 
kejä: 
MOUSEBUTTONS välitetään tieto hiiren nappuloista 


MOUSEMOVE tieto hiiren liikkeistä 

MENUPICK tieto valikoiden käytöstä 

CLOSEWINDOW tieto sulkunappulan käytöstä 

RAWKEY koodaamaton tieto näppäimistöltä 

VANILLAKEY ASCII-tieto näppäimistöltä 

Tulos: Näyttöön avautuu uusi ikkuna ja DO:ssa palautetaan osoitin ikkunan 


tiedot sisältävän Window-structuren alkuun. Tätä osoitinta tarvitaan mm. ikku- 
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naa suljettaessa. Jos ikkunan avaaminen ei onnistunut(muisti ei riitä tms.), DO:n 
arvo on nolla. 


REMAKEDISPLAY 

Nimi: RemakeDisplay -- järjestää kaikki näytöt 

Kutsu: RemakeDisplay() 

Parametrit: - 

Toiminta: RemakeDisplay-rutiini kutsuu MakeScreen()-rutiinia jokaista näyt- 
töä varten, minkä jälkeen se kutsuu RethinkDisplay()-rutiinia, joka tutkii näyttö- 
jen keskinäiset suhteet ja muodostaa uudet copper-listat. RemakeDisplay-rutii- 
nia kutsuttaessa kannatttaa huomioida, että rutiinin ajo saattaa viedä useita mil- 
lisekunteja. Siksi RemakeDisplay-rutiinia kannattaa käyttää harkiten. 


Tulos: Copper-apuprosessorille on muodostettu uusi ohjelma. 
SCREENTOBACK 
Nimi: * ScreenToBack -- siirretään haluttu näyttö kuvaruudussa 
takimmaiseksi 


Kutsu: ScreenToBack (A0) 

Parametrit: AO = näytön Screen-structuren osoite 

Toiminta: ScreenToBack-rutiini siirtää halutun näytön kuvaruudussa kaikki- 
en muiden näyttöjen taakse. Näytön koordinaatit eivät muutu. 


Tulos: Näyttö siirtyy takimmaiseksi. 
SCREENTOFRONT 
Nimi: ScreenToFront -- siirretään haluttu näyttö kuvaruudussa 
päällimmäiseksi 


Kutsu: ScreenToFront (A0) 

Parametrit: AO = näytön Screen-structuren osoite 

Toiminta: ScreenToFront-rutiini siirtää halutun näytön kuvaruudussa kaikki- 
en muiden näyttöjen eteen. Näytön koordinaatit eivät muutu. 


Tulos: Näyttö siirtyy päällimmäiseksi. 
SETPREFS 

Nimi: SetPrefs -- asettaa preferences-arvot oman Preferences- structuren 
mukaan 


Kutsu: SetPrefs (A0, D0, D1) 

Parametrit: AO = käyttäjän Preferences-structuren alkuosoite; DO = Prefere- 
ces-structuren pituus tavuina; DI ilmaisee, ovatko Preferences-asetukset lopulli- 
set. Jos DI on nolla, ei Intuition ilmoita muille ohjelmille Preferences-arvojen 
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vaihtamisesta. Jos DI ei ole nolla, asetukset ovat lopulliset ja kaikille asiasta 
kiinnostuneille ohjelmille ilmoitetaan, että Preferences-arvoja on muutettu. 

Toiminta: Käyttäjän määrittelemät Preferences-arvot asetetaan käyttöön. Täl- 
löin esimerkiksi näytön värit ja hiiren nopeus muuttuvat. Tarvittaessa muille oh- 
jelmille ilmoitetaan uusista, lopullisista Preferences-asetuksista. 

Haluttaessa muuttaa vain yksittäisiä Preferences-arvoja kannattaa ensin lukea 
käytössä olevat arvot GetPrefs- rutiinilla, muuttaa halutut arvot ja asettaa ne 
käyttöön tällä rutiinilla. 

Preferences-structuren listaus löytyy include-tiedostosta. Eri arvojen vaiku- 
tuksia on helppo kokeilla Preferences- ohjelman avulla. 

Tulos: Uudet Preferences-arvot asetetaan käyttöön. Muille ohjelmille 
ilmoitetaan tarvittaessa tapahtumasta. 


WINDOWTOBACK 
Nimi: WindowToBack -- siirretään haluttu ikkuna näytössä 
takimmaiseksi 


Kutsu: WindowToBack (A0) 

Parametrit: AO = ikkunan Window-structuren osoite 

Toiminta: WindowToBack-rutiini siirtää halutun ikkunan näytössä kaikkien 
muiden ikkunoiden taakse. Ikkunan koordinaatit eivät muutu. 


Tulos: Ikkuna siirtyy takimmaiseksi. 
WINDOWTOFRONT 
Nimi: WindowToFront -- siirretään haluttu ikkuna näytössä 
päällimmäiseksi 


Kutsu: WindowToFront (A0) 

Parametrit: AO = ikkunan Window-structuren osoite 

Toiminta: WindowToFront-rutiini siirtää halutun ikkunan näytössä kaikkien 
muiden ikkunoiden eteen. Ikkunan koordinaatit eivät muutu. 

Tulos: Ikkuna siirtyy päällimmäiseksi. 


Diskfont-kirjasto 


Diskfont-kirjasto sisältää levykepohjaisten fonttien käsittelyyn tarkoitettuja 
rutiineja. 

Diskfont-kirjasto on disk-resident-tyyppinen (se ladataan sitä avattaessa le- 
vykkeeltä), joten sitä käytettäessä on varmistuttava siitä, että boottilevykkeen 
libs-hakemisto sisältää diskfont.library-tiedoston. Muussa tapauksessa Diskfont- 
kirjastoa ei voida avata. 
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OPENDISKFONT 

Nimi: OpenDiskFont -- avaa massamuistissa olevan halutun fontin 

käyttöä varten 

Kutsu: D0 = OpenDiskFont (A0) 

Parametrit: AO = TextAttr-structuren osoite 

Toiminta: OpenDiskFont-rutiini etsii systeemin fonts: -hakemistosta TextAttr- 
structuren vaatimuksia parhaiten vastaavan fontin, ellei fontti ole jo muistissa, ja 
lataa sen. Normaalisti fonts: on boottilevykkeen fonts-hakemisto, mutta se voi- 
daan asettaa assign-komennolla muuhun hakemistoon. 

OpenDiskFont-rutiinin palauttamaa arvoa tarvitaan fonttia käytettäessä esi- 
merkiksi SetFont-rutiinin yhteydessä. Kun fonttia ei enää tarvita, se tulee sulkea 
CloseFont- rutiinilla, jolloin käyttöjärjestelmä voi tarvittaessa vapauttaa fontin 
vaatiman muistitilan. Katso myös OpenFont. 

Tulos: DO = fontin osoitin. Jos sopivaa fonttia ei löydy, on DO: arvo nolla. 
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migan ja 68000:n ohjelmointiin tarvittavaa tietoa alkaa tässä vaiheessa ol- 

la koossa niin paljon, että on aika tutkia ohjelmointiin tarvittavia apuohjel- 
mia ja aloittaa kokeileminen. MC68000:n käskyt muodostuvat vähintään 16 bi- 
tistä, joihin kuuluu useita eri kenttiä. Siksi käskyjen koodaaminen binääri- tai 
heksadesimaaliluvuiksi on lähes ylivoimainen tehtävä. Amigan ohjelmoinnissa 
kannattaa ehdottomasti käyttää monitoria tai makroassembleria. Kirjan mukana 
tulevalla levykkeellä on Timo Rossin tekemä ohjelma nimeltä Monitor, jolla voi 
tehdä pieniä ohjelmia sekä tutkia ja muuttaa muistin sisältöä - ja tietysti käyttö- 
järjestelmää. Monitorissa on myös lukuisia muita toimintoja, joista kerrotaan 
myöhemmin. 

Amigaan on saatavana tavallisten monitoriohjelmien lisäksi useita makroas- 
semblereja, joiden avulla assemblerohjelmointi helpottuu huomattavasti. Niiden 
tuottamaa koodia voidaan käyttää esimerkiksi C-kielisten ohjelmien funktioina 
tai keskeytysrutiineina. C-kielestä käsin assemblerilla kirjoitetut rutiinit näyttä- 
vät normaaleilta C:n funktioilta, kunhan ohjelmat vain linkataan yhteen ALINK- 
tai BLINK-linkkerillä. 

Makroassemblerilla on helppo tuottaa myös täysin itsenäisiä ohjelmia. Makro- 
assembleria käytettäessä ohjelmat editoidaan millä tahansa tekstieditorilla, joka 
pystyy tallentamaan tiedostot ASCII-koodina. Sitten ohjelma käännetään ja lin- 
kataan, jolloin se on valmis ajettavaksi. Kääntäminen ja linkkaaminen saadaan 
tehtyä yhdellä komennolla batch-tiedostoa käyttämällä. 


93 


Assemblerkääntäjistä 


Tämän kirjan esimerkkien kirjoittamiseen on käytetty TxEd-nimistä editoria 
ja Metacomcon Macro Assembler -ohjelmaa. 


Makroassemblerin edut ja haitat 


ohjelman kehitystyöhön verrattuna: 

+ Voidaan hyödyntää Amigan ns. include-tiedostoja, joissa on määritelty kaik- 
ki käyttöjärjestelmään kuuluvat structuret ja vakiot. Näin eri bittejä esimerkiksi 
grafiikkamuodon asettamiseen ei tarvitse muistaa ulkoa, vaan ne voidaan korva- 
ta havainnollisemmilla sanoilla, kuten HIRES, HAM ja DUALPF. 
alussa, koska ohjelmat linkataan käännöksen jälkeen amiga.lib-tiedoston kanssa. 
Tällöin symboliset kutsuosoitteet (OpenLibrary, Delay jne.) korvataan niitä vas- 
taavilla lukuarvoilla. 

+Ohjelmien kirjoittamisessa voidaan käyttää apuna makroja ja ehdollista 
kääntämistä. Makrojen avulla voidaan korvata MC68000:n käskykannasta puut- 
tuvia käskyjä ja aliohjelmia. Esimerkiksi kirjastojen avaamista, kutsumista ja 
sulkemista varten kannattaa tehdä makrot. Sitten Dos-kirjaston avaaminen onnis- 
tuu esimerkiksi komennolla 

openlib Dos 

ja sulkeminen komennolla 

closlib Dos. 

Kirjastorutiinin Delay kutsuminen voisi tapahtua esimerkiksi komennolla 

lib Dos,Delay . 

sen sijaan, että olisi ensin ladattava a6:een Dos-kirjaston perusosoite ja käytet- 
tävä jsr LVODelay(a6) -komentoa. 

Ehdollisen kääntämisen ansiosta voidaan ohjelmaan määritellä vaihtoehtoisia 
osuuksia, joista esimerkiksi yksi käännetään ohjelman alussa asetetun vakion pe- 
rusteella. Tällöin on mahdollista muuttaa ohjelma vaikkapa hyödyntämään lisä- 
muistia muuttamalla vain ohjelman alussa olevaa lukua (edellyttäen tietysti, että 
kaikki vaihtoehtoiset rutiinit on jo kirjoitettu). 

Ehdollisesta kääntämisestä on huomattavaa hyötyä myös tehtäessä "älykkäi- 
tä" makroja, jotka käyttäytyvät eri tavoin riippuen niille annetuista parametreista. 

-Pitkien tiedostojen kääntäminen usein huomattavasti hitaampaa kuin monito- 
reilla. 

-Vaatii vakavampaa käyttöä ajatellen kaksi levyasemaa ja/tai laajennusmuistia 
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Monitoriohjelmien edut ja haitat 


Monitoriohjelmien käytölläkin on ohjelmoinnissa hyvät puolensa. Esimerkik- 
si ohjelmien testaamisessa monitori saattaa osoittautua jopa välttämättömäksi. 

+Monitorin avulla ohjelmien kääntäminen ja kokeileminen on nopeaa. 

+Monitoreilla voidaan tutkia ja muuttaa muistia. 

+Jotkut monitorit sallivat jopa ASCII-muotoisten levytiedostojen kääntämi- 
sen (mutteivat makroja eivätkä include-tiedostoja). 

+Toimii myös yhden levyaseman ja 512K RAM-muistin kanssa erittäin hy- 
vin. 

-Suurten ohjelmien tekeminen vaikeaa. 

-Rutiinien tekeminen esimerkiksi C-kieltä varten on vaikeaa, koska ohjelmia 
ei voi linkata normaalisti. 


Ken on Amigassa kätevin? 


Pienten ohjelmien tekemiseen monitorit sopivat varsin hyvin. Suurten ja mo- 
nimutkaisten ohjelmien kirjoittaminen niillä on kuitenkin työlästä. Myös ohjel- 
mien luettavuus paranee makroassempbleria käytettäessä, koska kaikki Amigaan 
liittyvät vakiot ovat helposti käytettävissä include-tiedostojen muodossa. Makro- 
jen avulla on myös mahdollista selkeyttää ohjelmaa huomattavasti. 

Molemmilla kääntäjätyypeillä on oma vannoutunut käyttäjäkuntansa. Lähes 
kaikki introjen ja demojen tekijät käyttävät monitorityyppisiä kääntäjiä, muut 
ohjelmoijat taas makroassemblereja, ammattikäytössä makroassembler on välttä- 
mätön. Jokaisen assemblerohjelmointia aloittelevan lieneekin parasta kokeilla, 
kumpi kääntäjätyyppi tuntuu mielekkäämmältä. 


Makroassemblerin käytöstä 


Seuraavassa tarkastellaan Metacomcon makroassemblerin käyttöä. Kääntäjäl- 
le annetaan lähdetiedosto, jonka on oltava ASCII-koodia. Kääntämisen tulokse- 
na syntyy objektitiedosto, joka muunnetaan linkkerin avulla ajettavaksi tiedos- 
toksi. Linkkeri voi myös liittää useita objektikoodeja yhdeksi kokonaisuudeksi. 
Näin tapahtuu esimerkiksi liitettäessä C-kieliseen ohjelmaan assemblerkielisiä 
rutiineja ja aina linkattaessa amiga.lib- tiedosto ohjelmaan. amiga.lib sisältää 
kaikkien käyttöjärjestelmärutiinien kutsuoffsetit linkkerin hyväksymänä objekti- 
koodina. 

Ohjelman kehityksen vaiheet makroassembleria käytettäessä ovat: 

1) ohjelman kirjoitus 
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2) kääntäminen, jos virheitä takaisin kohtaan 1) 

3) linkkaaminen, jos virheitä, kohtaan 1) 

4) testaaminen, jos virheitä, kohtaan 1) 

Metacomcon makroassemblerin komentorivin muoto on seuraava: 

ASSEM <lähdekooditiedosto> [-o <objektikooditiedosto>] 

[-1 <listaustiedosto>] [-h <header-tiedosto>] 

[-c <optiot>] [-i <include-hakemisto>] 

Hakasuluissa [] olevat parametrit ovat vapaaehtoisia. Kääntäjä ei tuota objek- 
tikooditiedostoa eikä listaustiedostoa, ellei niitä pyydetä komentorivillä. 


Optiot 


S tuottaa symbolitaulukon 

D estää local-tyyppisten symbolien tulostumisen 

C aiheuttaa pienten ja isojen aakkosten tulkitsemisen samoiksi symbolien ni- 
missä 

X tuottaa ristiviittaustaulukon listaustiedoston loppuun 

Esimerkki: 

ASSEM koe.asm -o koe.o -1 koe.lst -i dfO:include 

kääntää koe.asm-nimisen tiedoston, tuottaa objektikoodin tiedostoon koe.o ja 
käännöslistauksen tiedostoon koe.lst sekä hakee include-tiedostot asemassa dfo: 
sijaitsevasta include- hakemistosta. 


Linkkerin käytöstä 


Kun ohjelma on käännetty ASSEM-komennolla, se täytyy linkata ennen sen 
ajamista. Linkkaamiseen voidaan käyttää joko Commodoren alkuperäistä 
ALINK-ohjelmaa tai uudempaa ja nopeampaa BLINK-ohjelmaa. Aikaisemmat 
BLINKin versiot ovat julkisohjelmia, uudemmat versiot kuuluvat Latticen C- 
kääntäjäpakettiin. 

Linkkerin komentorivi: 

BLINK FROM <linkattavat tiedostot> [TO <ajettava tiedosto>] 

[WITH <tiedosto>] [VER <tiedosto>] 

[LIB <kirjastotiedostot>] [MAP <tiedosto>] 

[XREF <tiedosto>] [WIDTH n] 

Parametrien merkitykset: 

FROM <linkattavat tiedostot> esim. kääntäjän tuottamat objektitiedostot, 
jotka liitetään yhteen ajettavaksi ohjelmaksi. 

TO <ajettava tiedosto> linkkerin tuottaman ajettavan tiedoston nimi. 

WITH <tiedosto> voi sisältää normaalin linkkerin komentorivin. 
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VER <tiedosto> määrittelee tiedoston, johon linkkeri tulostaa tekstit (nor- 
maalisti kuvaruutu) 

LIB <kirjastotiedostot> määrittelevät tiedostot, joissa olevia rutiineja ja va- 
kioita ohjelmaan halutaan liittää (esim. amiga.lib) 

MAP <tiedosto> määrittelee tiedoston, johon tulostetaan symbolikartta 

XREPF <tiedosto> määrittelee tiedoston, johon tulostetaan ristiviitekartta 
daan esim. tulostaa kirjoittimella 

Esimerkki: 

BLINK koe.o TO koe LIB df0:amiga.lib 

linkkaa koe.o-nimisen objektikooditiedoston ja tuottaa ajettavan tiedoston 
koe. Kirjastona käytetään amiga.lib-kirjastoa. 


Batch-tiedosto 


Kääntämisprosessi helpottuu huomattavasti, kun käytetään batch- tiedostoa. 
Tällöin sekä kääntäminen että linkkaaminen tapahtuvat yhtä komentoa käyttäen. 
Alla olevaa tiedostoa käyttäen aikaisempi koe.asm-ohjelman kääntäminen käy 
seuraavasti: 

execute help koe <return> 

(oletettuna, että batch-tiedosto on tallennettu levylle nimellä help). Jos vielä 
nimeää execute-komennon vaikkapa e:ksi, rivi lyhenee entisestäänkin. Tämän 
batch-tiedoston käyttö edellyttää, että include-tiedostot löytyvät hakemistosta 
df0:include ja kirjasto amiga.lib df0:n päähakemistosta. 

Batch-tiedoston listaus: 

Key file 

if not exists <file>.asm 

echo "File <file>.asm does not exist. Try again." 

skip END 

endif 

echo "-- compiling...<file>.asm" 

assem <file>.asm -o <file>.o -i df0:include 

echo ""' 

echo "-- Linking... <file>.o to create <file>" 

blink FROM <file>.o TO <file> LIB df0:amiga.lib 


echo "" 
echo "-- done linking <file>”. --" 
LAB END 
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Makroassemblerin 
lähdekoodi 


[< rivien sisältö on kaikille assemblereille tyypillinen. Rivin va- 
semmassa reunassa on mahdollinen symboli, jota seuraa ainakin yksi väli- 
lyönti tai tabulaattori. Seuraavana on käskyn tai makron nimi, siihen mahdolli- 
sesti kuuluvat parametrit ja lopuksi mahdollinen kommentti, joka on hyvä erot- 
taa muusta rivistä puolipisteellä. Lähdekoodin rivi voisi siis olla esimerkiksi seu- 
raava: 

silmukka move.I1 d0,(a0)+ ; siirretään luku muistiin 

Jos symboli puuttuu, on rivin alussa oltava ainakin yksi välilyönti tai tabulaat- 
tori. 


Symbolien ja makrojen nimet 


Symbolien ja makrojen nimien on alettava jollakin kirjaimella, alleviivausvii- 
valla ( ) tai pisteellä (.). Muut nimen merkit voivat olla myös numeroita. Nor- 
maalisti pienet ja isot aakkoset tulkitaan eri kirjaimiksi, joten AMIGA ja Amiga 
ovat eri symboleja. Maksimi symbolin nimen pituus on 30 merkkiä. 

Makroissa voidaan käyttää myös symboleja, joiden nimessä on X. Tällöin 
NO" korvataan luvulla "nnn", missä nnn on alussa 000, mutta kasvaa jokaisen 
makron yhteydessä. Näin saadaan kaikkiin makroihin yksilölliset symbolien ni- 
met. 

Prosessorin rekistereistä voidaan käyttää seuraavia merkintöjä: 

pc —ohjelmalaskuri 

sp — pino-osoitin (eli a7) 

usp käyttäjän pino-osoitin 

SSp systeemin pino-osoitin 

cer = tilarekisteri (condition code register) 

sr — status-rekisteri 


Luvut 


Assembler tuntee kymmenjärjestelmän lisäksi myös binääri-, oktaali- ja hek- 
sadesimaalijärjestelmät. Eri järjestelmien luvut erotetaan toisistaan seuraavasti: 
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-ei tunnusta: 10-järjestelmä (merkit 0...9 kelpaavat) 

- tunnus $: 16-järjestelmä (merkit 0...9 ja a...f kelpaavat) 

- tunnus O: 8-järjestelmä (merkit 0...7 kelpaavat) 

- tunnus %: 2-järjestelmä (merkit O ja 1 kelpaavat) 

- tunnus "": ASCII-merkit (maksimi 4 kpl) 

Esimerkkejä: 

$12345678 = 305419896 = (02215053170 = 
%10010001101000101011001111000 

Heksadesimaaliluvuissa hyväksytään isot ja pienet kirjaimet. 

"LUKU" = $4c554b55 

"ok" = $00006f6b 


Operaattorit 


Assemblerin hyväksymät operaattorit ovat: 
1. miinus-etumerkki, looginen EI (- ja -) 
2. siirto vasemmalle ja oikealle (< ja >) 

- looginen JA, TAI (& ja !) 

- kerto- ja jakolasku (* ja /) 

. yhteen- ja vähennyslasku (+ ja -) 

Em. operaattoreita sisältävät lausekkeet lasketaan kääntämisen, EI ohjelman 
ajon aikana. Operaattorien käsittelyjärjestys on ylläolevan mukainen. Haluttaes- 
sa voidaan käyttää sulkuja (), jolloin sulkulausekkeen arvo lasketaan ensim- 
mäisenä. Huomaa, ettei lausekkeissa saa käyttää välilyöntejä, koska ne tulkitaan 
lausekkeen loppumisen merkiksi. 


n £ O 


Osoitusmuodot ja käskykanta 


Kääntäjä tukee kaikkien MC68000:n osoitusmuotojen käyttöä. Useimpien 
käskyjen yhteydessä on myös määriteltävä haluttu toiminnan koko (tavu = .B, 
sana = W ja pitkä sana = L). Ellei niin tehdä, kääntäjä olettaa kooksi W eli 16 
bittiä. g 

Käskyjen nimet, koon ja rekisterien tunnukset voi kirjoittaa joko isoilla tai 
pienillä kirjaimilla. 

Makroassembleri hoitaa automaattisesti käskyjen eri muodot 

(MOVE/MOVEA, SUB/SUBA jne.), joten ohjelmoija voi kirjoittaa kaikkien 
tilalle käskyn perusmuodon, esim. MOVE. Samoin ehdollisten hyppykäskyjen 
koko ($8 tai 16 bittiä) valitaan automaattisesti pienimmäksi mahdolliseksi. 

Eri osoitusmuotojen käyttö selviää esimerkeistä: 
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MOVE.L 
MOVEA.L 
MOVE.W 
MOVE.B 
MOVE.B 
MOVEB 
MOVEB 
MOVE.B 
MOVE.B 


MOVE.L 


D3,D4 suora osoitus 

AO0A1 suora osoitus 

DO,$DFF180 absoluuttinen osoitus 

DO.(A0) epäsuora osoitus 

D0(A0)+ epäsuora autoindeksoitu 

D0,-(A0) epäsuora autoindeksoitu 

D0,14(A0) epäsuora 16 bitin offsetilla 

D0,2(40,D0) epäsuora indeksoitu 8 bitin offsetilla 

100(PC),D0 ohjelmalaskuriin suhteellinen 16 bitin 
offsetilla 


100(PC.D0),D2 ohjelmalaskuriin suhteellinen 
indeksoitu 8 bitin offsetilla 


Jos indeksoiduissa osoitusmuodoissa indeksirekisterin kokoa (.W tai .L) ei il- 
moiteta, käytetään arvoa .W. Siis esimerkiksi 

MOVE.B D0,4(A0,D0) = MOVE.B D0,4(A0,D0.W). 

Jos indeksirekisterin kooksi määritellään W, otetaan osoitetta laskettaessa 
huomioon vain indeksirekisterin 16 alinta bittiä. Jos kokomäärite on .L, otetaan 
laskennassa huomioon kaikki indeksirekisterin bitit. 


Kääntäjän 


komennot 


Metacomcon makroassembleriin liittyy ehdollinen kääntäminen ja lukuisia 
muita toimintoja, joita ohjataan erityisillä assembler-käskyjä muistuttavilla ko- 
mennoilla. Seuraavassa on luettelo tärkeimmistä: 


END 
EOU 
SET 

DC:s 


DCB:s 
DS.s 
PAGE 
LIST 
NOLIST 
SPC n 
NOPAGE 
LLEN n 
PLEN 
kyä 


ohjelman loppu 

määritellään pysyvä symbolin arvo 

määritellään väliaikainen symbolin arvo 
sijoitetaan muistiin vakioarvoja (tavuja = DC.B, 
sanoja = DC.W ja pitkiä sanoja = DC.L) 
määrittelee muistiin vakiolohkon (.B, W tai .L) 
varaa tilaa muuttujille (.B, .W tai .L) 

vaihtaa listatessa sivua 

aloittaa listauksen 

lopettaa listauksen 

tulostaa listaukseen n tyhjää riviä 

estää sivutuksen listattaessa 

asettaa rivin pituuden merkkeinä (59 <n < 133) 
asettaa sivun pituuden riveinä (23 <n < 101) 
asettaa ohjelman otsikon listaukseen (maks. 80 merkkiä) 
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CNOP 
IFEO 
IFNE 
IFGT 
IFGE 
IFLT 
IFLE 
IFC 
IFNC 
IFD 
IFND 
ENDC 
MACRO 
ENDM 
MEXIT 
XDEF 


XREF 


ehdollinen NOP sanan rajan tasaamista varten 
käännös tapahtuu, jos lauseke = 0 

käännös tapahtuu, jos lauseke <> 0 

käännös tapahtuu, jos lauseke > 0 

käännös tapahtuu, jos lauseke >= 0 

käännös tapahtuu, jos lauseke <0 

käännös tapahtuu, jos lauseke <= 0 

käännös tapahtuu, jos merkkijonot ovat identtiset 
käännös tapahtuu, jos merkkijonot eivät ole identtiset 
käännös tapahtuu, jos symboli on määritelty 

käännös tapahtuu, jos symbolia ei ole määritelty 
lopettaa edellisen ehdon vaikutuksen 

aloittaa makron määrittelyn 

poistuu makrosta 

määrittelee symbolin tunnetuksi ohjelman ulkopuolella 
(muissa linkattavissa ohjelmissa) 

viittaus ulkoiseen symboliin (kirjastoihin tai muihin 
linkattaviin ohjelmiin) 


INCLUDE lukee include-tiedoston 


Makrot 


Makro muodostuu tavallisesti pätkästä normaalia ohjelmakoodia. Jos ohjel- 


jokaista viivaa kohden kirjoittamaan seuraava koodipätkä: 


move.1 
move.l 
move. 
move.l 
jsr 

move.l 
move.1 
move.I1 
jsr 


fx1,d0; alkupiste (x1,y1) 


fyl,d1 

rastport,al ;rastport, johon piirretään 
GfxBase,a6 

 LVOMove(a6) ; siirtää kynän 

fx2,d0 s loppupiste (x2,y2) 

tHy2,d1 

rastport,a1 

 LVODraw(a6) 3 piirtää viivan 


Sen sijaan, että käytettäisiin ylläolevaa koodia, voidaan ohjelman alussa mää- 
ritellä makro, joka ensin siirtää kynän halutun viivan alkupisteeseen ja sitten 
piirtää viivan loppupisteeseen. Makrolle annetaan neljä parametria: alku- ja lop- 
pupisteen x- ja y-koordinaatit. Olkoon makron nimi LINE: 
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LINE macro 
move.] F1,d0 
move.l HV, d1 


move.] rastport,a1 
move.l GfxBase,a6 
jsr  LVOMove(a6) 


move.] F3,d0 

move. 14, d1 

move.l rastport,a1 

jsr  LVODraw(a6) 

endm 

Kun makro on määritelty, sen käyttö on helppoa. Esimerkiksi viivan piirtämi- 
nen pisteestä (10,20) pisteeseen (104,246) onnistuu komennolla 

LINE 10,20,104,246 

sen sijaan, että olisi kirjoitettu nuo viivan piirtoon normaalisti tarvittavat yh- 
deksän riviä. 

Mitä makroa käytettäessä sitten oikein tapahtuu? Kääntäjä yksinkertaisesti 
korvaa makron nimen aiemmin ilmoitetulla makron koodilla. Siis LINE korvau- 
tuu juuri samoilla yhdeksällä assemblerkäskyllä, joita muutenkin käytettäisiin. 
Homma vain helpottuu, koska ohjelmoijan tarvitsee kirjoittaa vain yksi rivi. Täl- 
löin ohjelmasta tulee myös huomattavasti selkeämpi. Makroa määriteltäessä käy- 
tettiin merkintöjä N 1,N2,V3 ja X4. Kun kääntäjä "purkaa" makroa löytäessään 
viitteen siihen (tässä tapauksessa rivin, jolla on LINE-käsky), se korvaa 'N 1"':n 
ensimmäisellä makron nimen perään kirjoitetulla parametrilla, 'N2":n toisella 
jne. Kun assembler kohtaa rivin 

LINE 10,20,30,40 

se korvautuu siis koodilla 

move.] 110,d0 

move. 420,d1 

move.l GfxBase,a6 

move.1 rastport,a1 

jsr —LVOMove(a6) 

move. 1130,d0 

move. 140, d1 

move.l rastport,al 

jsr  LVODraw(a6) 

Koska makron sisältö kuitenkin sijoitetaan käännettyyn ohjelmakoodiin sen 
jokaisella käyttökerralla, ohjelman pituus ei muutu makrojen käytön seuraukse- 
na. Usein osa makrosta voidaan kuitenkin helposti korvata aliohjelmalla, jolloin 
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itse makroon kuuluva koodi lyhenee. Koska aliohjelma tarvitsee sijoittaa ohjel- 
maan vain kerran, ohjelma lyhenee usein huomattavasti. Seuraavassa LINE- 
makron parempi versio, jossa viivan piirtäminen tapahtuu aliohjelmassa. 

LINE2 — macro 

move. F1,d0 

move.] — 402,d1 

move.1 13,d2 

move.I1 F4,d3 

bsr draw In 

endm 

Kuten huomataan, makro lyheni lähes puoleen. Silti sen käyttö on täsmälleen 
samanlaista kuin edellisessäkin esimerkissä. Erona on se, että nyt tarvitaan mak- 
ron lisäksi draw In - aliohjelma: 

draw In —move.lrastport,al 

move.] GfxBase,a6 

jsr  LVOMovela6) 

move. d2,d0 

move. d3,d1 

move.l rastport,al 

jsr  LVODraw(a6) 

rts 

Jos makroa käytetään ohjelmassa ainakin kolme kertaa, on aliohjelmaa käyttä- 
vä version muistin säästämisen kannalta parempi. Aliohjelmakutsu hidastaa oh- 
jelman ajoa hieman alle 0.000005 s/viiva, mikä esimerkiksi 10000 viivaa kohti 
merkitsee vasta n. 0.05 sekuntia. Aliohjelmassa käytetään hyväksi tietoa, että 
käyttöjärjestelmän rutiinit eivät muuta rekisterien d2-d7 ja a2-a6 arvoja kutsun 
aikana. Siten viivan loppukoordinaatit voidaan tallentaa makrossa rekistereihin 
d2 ja d3 ja siirtää ne niistä dO:aan ja d1:een ennen Draw-rutiinin kutsumista. 

Aliohjelmaakin käyttävä versio säästää huomattavasti kirjoitustyötä, jäävät- 
hän neljä move.1-käskyä ja bsr pois LINE2-makroa käyttämällä. 

Makroihin saadaan hieman "älykkyyttä" käyttämällä ehdollista kääntämistä. 
Otetaanpa esimerkki: MC68000 ei sisällä varsinaisia pinokäskyjä, joilla proses- 
sorin rekisterejä voisi tallentaa pinoon ja hakea sieltä. Korvataan puute makroil- 
la PUSH ja PULL: 
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PUSH macro 

ifc "YL","all" 
movem.! d0-d7/a0-a6,-(sp) 
endc 


ifnc"","all" 
movem.! —1,-(sp) 
endc 

endm 


PULL macro 

ifc "YI", "all" 

movem.I (sp)+,d0-d7/a0-a6 

endc 

inc "1","all" 

movem.I1 (sp)+,1 

endc 

endm 

* Molemmat makrot käyttävät movem.l1-käskyä, jolla voidaan tallentaa kaikki 
prosessorin rekisterit kerralla. Makroissa käytetään ehdollista kääntämistä, jossa 
käännös riippuu makroille annetusta parametrista. Testaamiseen käytetään käs- 
kyjä IFC ja IFNC, jotka vertaavat kahta merkkijonoa toisiinsa. Jos parametrina 
on sana "all" eli kaikki, assembler kääntää makrosta PUSH rivin 

movem.1 d0-d7/a0-a6,-(sp). 

Jos taas parametri on jotakin muuta, esimerkiksi a4, kääntyy vain 

movem.! a4,-(sp). 

Näin vältytään kirjoittamasta koko rekisteriluetteloa "d0-d7/a0- a6" joka ker- 
ta, kun halutaan tallentaa kaikki rekisterit pinoon. Huomaa, ettei rekisteriä A7 
eli pino-osoitinta tallenneta pinoon! 

PULL-makro toimii vastaavalla tavalla. PUSH- ja PULL-makroja voidaan 
käyttää esimerkiksi aliohjelman alussa ja lopussa seuraavasti: 


aliohjelma PUSH all ; tallentaa kaikki rekisterit 
..toiminta... ; varsinainen aliohjelma 

PULL all ; palauttaa rekisterien arvot 
rts ; poistuu aliohjelmasta 


Lisäesimerkkejä makrojen käytöstä on liitteissä ja levykkeellä olevissa ohjel- 
malistauksissa. Myös include-tiedostoissa on käytetty runsaasti yksinkertaisia 
makroja ja ehdollista kääntämistä. Valmiita tiedostoja tutkimalla oppii paljon uu- 
sia asioita. 
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SEKA-assemblerin käytöstä 


SEKA-assembler on monitorityyppinen ohjelma, joka kuitenkin sallii ASCII- 
muotoisten lähdekoodien kääntämisen ja editoimisen. Seuraavassa esitellään ly- 
hyesti SEKA-assemblerin komentoja ja kääntämistapahtumaa. 

SEKA-käskyt: 

Esc =Kääntäjä --> editori --> kääntäjä 

R =Lukee lähdekoodin massamuistista 

RI =Lukee johonkin määrättyyn muistiosoitteeseen 

W =Tallentaa lähdekoodin massamuistiin 
muistiin 

WO =Tallentaa käännetyn koodin levylle ajettavana koodina 

O =Antaa tietoja käännetystä koodista 

N =Disassemble-komento 

M =Näyttää muistia halutusta osoitteesta lähtien 

X =Rekisterien tulostus 

KS =Tyhjennä lähdekoodi muistista 

J =Hyppää käännetyn koodin alkuosoitteeseen 


SEK Alla kääntäminen 


Seka-assemblerilla kääntäminen on nopeaa, koska käännettäessä ei tarvita 
linkkeriä. Ohjelma on myös mahdollista kääntää haluttuun absoluuttiseen osoit- 
teeseen antamalla osoite ohjelman lähdekoodin alussa seuraavalla tavalla: 

ORG = $osoite, josta käännetty koodi alkaa 

LOAD = $osoite, josta käännetty koodi alkaa 

Lähdekoodin kääntäminen tapahtuu seuraavalla tavalla: 

1) Lataa käännettävän ohjelman lähdekoodi muistiin R-komennolla. 

2) Käännä ohjelma A-komennolla. Jos ohjelma kääntyi ilman virheilmoituk- 
sia voit ajaa ohjelman J-komennolla. Jos ohjelma palasi ajosta oikein ja toimi ha- 
lutulla tavalla, kannattaa ohjelmasta tallentaa versio (joka on ajettavissa levyk- 
keeltä CLI:n alaisuudessa) WO-komennolla. 

3) Ohjelman kirjoitusvaiheessa ei kannata käyttää Seka-assemblerin omaa 
editoria, vaan jotain muuta monipuolisempaa, jossa on mahdollisuus tallentaa 
ohjelma ASCII-koodina. 

Kun ohjelma käännetään Seka-assemblerilla, on sen testaaminen helpompaa 
kuin makroassembleria käytettäessä, koska Seka-assembleriin kuuluu myös ko- 
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nekielimonitorin tärkeimmät toiminnot. Ohjelman ajo ei myöskään kaadu laitto- 
maan käskyyn, vaan SEKA antaa ilmoituksen käskystä ja sen paikasta. Seka-as- 
semblerin hyviin puoliin voidaan laskea myös mahdollisuus ajaa ohjelmasta 
vain haluttu aliohjelma kutsumalla sitä käskyllä J +aliohjelman nimi. Seka-As- 
sembler on varsin käyttökelpoinen ohjelma niille, jotka eivät halua käyttää inclu- 
de-tiedostoja apuna ohjelmoinnissa. 

Kirjan seuraavassa osassa on esimerkkejä suuremmista Amigan ohjelmista. 
Osa esimerkeistä on pelkästään esimerkeiksi tehtyjä, osa taas täysin käyttökel- 
poisia ohjelmia. 


Monitor-ohjelma 


Kirjan mukana tulevalla levykkeellä on Timo Rossin tekemä Monitor-ohjel- 
ma, joka helpottaa paljon Amigan ohjelmointia. Seuraavassa esitellään lyhyesti 
tärkeimpiä monitorin käskyjä. Muut komennot saa näkyviin painamalla monito- 
riohjelmassa Help-näppäintä. Tässä komennot on kirjoitettu isoin kirjaimin, mut- 
ta monitori ymmärtää ne myös pienillä kirjaimilla annettuina. 

Heksadesimaalilukuja merkitään $:lla, desimaalilukuja +:lla. Normaalitilassa 
monitori olettaa kaikki luvut heksadesimaalisiksi, ellei lukujärjestelmää erityi- 
sesti mainita. 

Monitorissa saa entisiä komentorivejä takaisin korjailtaviksi painamalla kur- 
sori ylös -nappulaa. Kursori vasemmalle ja oikealle -näppäimillä voidaan riviä 
korjailla. 

Jos monitorilla ajettu ohjelma päättyy virheeseen, yleensä seurauksena EI ta- 
vallisuudesta poiketen ole gurun vierailu. Monitori tulostaa sen sijaan virhettä 
vastaavan viestin sekä prosessorin rekisterien arvot ja palaa komentotilaan. Vali- 
tettavasti monitorikaan ei aina onnistu yrityksessään, vaan kone kaatuu. Siksi ko- 
neessa mahdollisesti olevat työn tulokset kannattaa AINA tallentaa ensin levyk- 
tea... 

käsky toiminta 


A 0 aloittaa ohjelman kääntämisen annettuun 
osoitteeseen o, esim. A 50000 
Cola vertaa osoitteesta o alkavaa ja osoitteeseen 1] päättyvää 


muistialuetta osoitteesta a alkavaan alueeseen, 
esim. C 50000 60000 100000 

Do aloittaa disassemble-toiminnon, joka kääntää annetusta 
osoitteesta o alkaen muistissa olevaa ohjelmaa näytölle 
selväkieliseksi, esim. D 50000 
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tulostaa levykkeen hakemiston 

täyttää osoitteiden o ja 1 välisen alueen tavulla t (voi muodostua 
myös useista tavuista), esim. F 50000 60000 00 

hyppää ohjelman suoritukseen annettuun osoitteeseen o, 

esim. G 50000 

kutsuu annetusta osoitteesta o alkavaa aliohjelmaa, esim. J 50234 
tulostaa muistin sisältöä annetusta osoitteesta o alkaen, 

esim. M 50000 

lukutulostaa luvun heksadesimaalisena, desimaalisena, 
oktaalina ja binäärinä, esim. N 10 

näyttää prosessorin rekisterien sisällöt 

siirtää osoitteesta o alkavan ja osoitteeseen 1 päättyvän 
muistialueen osoitteeseen a, esim. T 50000 60000 100000 
suorittaa ohjelmaa käsky kerrallaan (walk) alkaen osoitteesta o. 
Osoitetta ei ole pakko antaa joka kerralla, esim. W 50000 
poistuu monitorista 

varaa muistia osoitteesta o annetun tavumäärän p. Jos muisti oli 
jo käytössä, tulostuu virhe, esim. & 50000 10000 

varaa halutun määrän p muistia ilmoittaen varatun alueen 
alkuosoitteen, esim. ( 10000 

vapauta varattu muisti, joka alkaa osoitteesta o. )all vapauttaa 
kaiken monitorilla varatun muistin 

tulostaa käskyluettelon 

lataa annettuun osoitteeseen o halutun tiedoston n, esim. [ 50000 
c:DClock 

avaa uuden CLI-ikkunan 

tallentaa osoitteesta o alkaen p tavua levykkeelle nimellä n, 
esim. ] 50000 330 DClock 
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Ohjelmoimaan - 
Crash! 


N on aika aloittaa kokeileminen. Aluksi kannattaa tehdä työkopio kirjan 
mukana tulleesta levykkeestä, jotta sen alkuperäiset tiedostot eivät vahin- 
gossa tuhoutuisi. Tähän voi käyttää esimerkiksi dosin diskcopy-komentoa, sillä 
levykettä ei ole kopiointisuojattu. Kirjan esimerkkiohjelmien kääntämiseen tar- 
vitaan makroassembleri, mutta seuraavassa kokeillaan lyhyen ohjelman kirjoitta- 
mista levykkeellä olevaa Monitori-ohjelmaa käyttäen. 


Ensimmäiset askeleet 


Aluksi kytketään Amigaan virta ja laitetaan levykkeen työkopio asemaan 
df0:. Kun CLI-ikkunaan ilmestyy vaste "1>", näppäillään run mon <return>, jol- 
loin monitoriohjelma latautuu muistiin. Help-näppäintä painamalla saa näyt- 
töön lyhyet selostukset kaikista monitorin tuntemista komennoista. 

Seuraavaksi varataan kirjoitettavalle ohjelmalle tilaa Amigan muistista. Tämä 
tapahtuu esimerkiksi komennolla &, joka varaa muistia annetusta osoitteesta al- 
kaen. Kirjoitetaan & 50000 10000 <return>, joka varaa $10000 tavua alkaen 
osoitteesta $50000 (normaalisti tässä osoitteessa on vapaata muistia). On huo- 
mattava, että assemblerkääntäjiä käytettäessä ei ohjelmaa kirjoitettaessa tunneta 
sen lopullista sijoittumista koneen muistiin ajon aikana. Sijoittuminen riippuu 
siitä, missä osoitteessa kulloinkin sattuu olemaan vapaata muistia. Esimerkkim- 
me taas tehdään monitorilla, jolloin sijoituskohta on kiinteä. 

Seuraavaksi annetaan monitorille komento a 50000 <return>, joka aloittaa as- 
semblerkielisen ohjelman syötön osoitteesta $50000 alkaen (siis alueelle, joka 
varattiin edellisellä komennolla). Tämän jälkeen voidaan aloittaa itse ohjelman 
syöttö. Tehdään yksinkertainen ohjelma, joka laskee miljoonasta nollaan ja pa- 
laa sitten takaisin monitorin alaisuuteen. Seuraavat ohjelmarivit syötetään sellai- 
sinaan monitorille a 50000 -komennon jälkeen. Jokaisen rivin lopussa painetaan 
<return>. 

move. 1+1000000,d0 

subg.! 41,d0 

bne $50006 

rts 
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Lopuksi painetaan pelkkä <return>, jolloin monitori palaa komentotilaan. Oh- 
jelma ajetaan komennolla j 50000 <return>. Ensimmäisellä rivillä ladataan rekis- 
teriin DO miljoona, jota pienennetään ykkönen kerrallaan toisella käskyllä. BNE 
tarkistaa, oliko vähennyslaskun tulos nolla. Ellei, palataan takaisin vähennyskäs- 
kyyn. Kun tulos on nolla, suoritetaan RTS-käsky ja palataan takaisin monitorin 
komentotilaan. Tällöin monitori tulostaa prosessorin rekisterien sisällöt. 

Haluttaessa tutkia tarkemmin ohjelman toimintaa voidaan käyttää monitorin 
w-käskyä, joka suorittaa ohjelmaa käsky kerrallaan. Jokaisen käskyn suorituk- 
sen jälkeen tulostetaan prosessorin rekisterien sisällöt ja seuraavana ajettava käs- 
ky. Antamalla komento w 50000 aloitetaan äskeisen ohjelman suoritus. Seuraa- 
va käsky voidaan ajaa komennolla w (osoitetta ei tarvitse antaa kuin ensimmäi- 
sellä kerralla). Kun ohjelmaa ajetaan käsky kerrallaan, huomataan, että DO:n ar- 
vo pienenee ykkösellä jokaisella silmukan kierroksella. Haluttaessa voidaan oh- 
jelman alussa olevaa lukua (1000000) pienentää, jolloin ohjelma päättyy jo esi- 
merkiksi kymmenen kierroksen jälkeen. 


Miten ei saa tehdä 


Kokeillaan seuraavaksi ohjelmaa, jossa on tahallinen virhe. Aluksi annetaan 
jälleen a 50000 -komento, jonka jälkeen syötetään seuraavat rivit: 

move.] $50000,d0 

move.b $50001,d1 

move.1 $50001,d2 

rts 

Ohjelman ensimmäinen rivi siirtää DO:aan 32-bittisen luvun osoitteesta 
$50000. Tämä on oikein, koska osoite on parillinen. Toinen käsky siirtää muisti- 
paikan $50001 sisällön D1:een. Koska siirrettävän luvun koko on yksi tavu, voi 
käskyssä yritetään siirtää 32-bittinen eli nelitavuinen luku parittomasta osoittees- 
ta rekisteriin D2. Koska MC68000 ei pysty siirtämään parittomasta osoitteesta 
kuin tavuja, aiheutuu address error eli guru 3. Jos ohjelma ajetaan monitorista 
käsin, ei ongelmaa pitäisi syntyä, koska monitori tulostaa itse virheilmoituksen 
eikä päästä gurua häiritsemään ohjelmoijan mielenrauhaa. Ohjelma kannattaa 
ajaa w 50000 -komennolla, jotta toimivat ja virheelliset käskyt voisi erottaa toi- 
sistaan. Kuten huomataan, kaksi ensimmäistä komentoa toimivat oikein, mutta 
kolmas aiheuttaa virheen. 

Suurempien ohjelmien tekeminen monitorin avulla on työlästä. Monitorista 
puuttuu myös toiminto, jolla ohjelma saataisiin tallennettua levykkeelle tavalli- 
seksi ajettavaksi tiedostoksi. Siksi ohjelmat on aina ladattava ensin muistiin sa- 
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maan osoitteeseen, mistä ne oli tallennettu ja vasta sitten käynnistettävä. Assem- 
blerkääntäjiä käytettäessä kääntäjä liittää ohjelmakoodiin tiedot, joiden avulla 
ohjelma voidaan ladata mihin kohtaan muistissa tahansa. Amigan käyttöjärjestel- 
män latausrutiini korvaa kaikki ohjelman viittaukset itseensä niillä osoitteilla, 
jotka vastaavat kulloistakin ohjelman sijoittumista muistiavaruudessa. Jos ohjel- 
matiedosto ei sisällä lataajan tarvitsemia tietoja, ohjelmaa ei voida ladata nor- 
maalisti ja AmigaDOS tulostaa virheilmoituksen. 

Äskeinen esimerkki aiheutti virheen 3. Address error -virheen lisäksi toinen 
yleinen virheilmoitus on Illegal instruction (numero 4). Tämä aiheutuu jos 
MC68000 yrittää suorittaa sellaisen luvun, joka ei vastaa mitään konekielen käs- 
kyä. Yleensä guru 4 on seurausta siitä, että prosessori on syystä tai toisesta har- 
hautunut pois varsinaisen ohjelmakoodin alueelta (RTS puuttuu tai jokin hyppy- 
osoite on väärä) ja noutaa käskykoodeja esimerkiksi muuttuja-alueelta tai pino- 
muistista. Seuraavissa kappaleissa tarkastellaan eri gurujen aiheuttajia ja keinoja 
estää gurun vierailut. 


Guru vieraisilla - Amigan virheilmoitukset 


Amigan ylivoimaisesti inhotuin näytössä näkyvä laatikko on guru-ilmoitus eli 
alert. Alert on Amigan tapa ilmoittaa käyttäjälle, että ohjelmaa suoritettaessa on 
tapahtunut jokin vakava virhe. Alert ei koskaan johdu käyttäjän tekemästä vir- 
heestä, vaan ohjelmistossa olevasta viasta (bugista). Käytännössä on kuitenkin 
huomattu, että joidenkin ohjelmien tietyt toiminnot aiheuttavat (toiminnossa ole- 
van ohjelmavirheen vuoksi) säännöllisesti alert-laatikon ilmaantumisen kuvaruu- 
tuun, joten käyttäjä pystyy välttämään gurun vierailuja välttämällä tällaisten toi- 
mintojen käyttöä. Koska alert aiheuttaa yleensä koneen nollaamisen ja tietojen 
menetyksen, kannattaa ohjelmoijan nähdä vaivaa poistaakseen ohjelmastaan 
kaikki koneen kaatumiseen johtavat virheet. Valitettavasti tämä ei aina ole help- 
poa, mikä näkyy myös useiden kaupallisten ohjelmien toiminnassa. 

Käyttäjän kannalta on varsin vähän tehtävissä, jos näyttöön ilmaantuu alert. 
Ohjelmoijalle tuo pelätty neliö taas kertoo arvokasta tietoa siitä, mikä on vir- 
heen mahdollinen aiheuttaja. Jäljempänä esitetyissä taulukoissa on kerrottu, mi- 
tä alerttiin kuuluvat luvut kertovat tapahtuneesta virheestä. Luvuista ei aina ole 
apua, mutta niiden viesti kannattaa kuitenkin tulkita etsittäessä virhettä ohjel- 
masta. Ellei virhe löydy alertin tietojen perusteella, voi kokeilla ohjelman aja- 
mista kirjan mukana seuraavasta monitoriohjelmasta käsin. Monitori kertoo 
alerttia enemmän virheen syystä ja sijainnista ja sen avulla on lisäksi mahdollis- 
ta suorittaa ohjelmaa käsky kerrallaan, jolloin virheellinen kohta on helpompi 
paikantaa. 
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Jäljempänä esitettyjä tietoja ei ole yritetty kääntää suomeksi, sillä seuraukse- 
na olisi vain kielten sekasotku, josta kukaan ei saisi selvää. 


Bugien metsästystä 


Amigalle on saatavana ainakin GOMF! -niminen ohjelma, jonka pitäisi estää 
alert-näytön ilmaantuminen kaikkien virheiden seurauksena. GOMF! versio 1.0 
on julkisohjelma, jota voi tiedustella esimerkiksi käyttäjäryhmiltä ja muilta Ami- 
ga- käyttäjiltä. Ohjelman paranneltu versio 2.0 sen sijaan ei ole julkisohjelma. 


Toinen hyvä apuohjelma gurujen varalle on ASDG Virtual Disk Drive VD0:. 
Se ei pyri estämään gurujen kyläkäyntejä, vaan tarjoaa boottaamisen kestävän 
RAM-levyaseman. Ohjelma on erityisen hyödyllinen, jos koneessa on suuri 
muistilaajennus. ASDG:n VD0: on myös julkisohjelma, jota saa vapaasti kopioi- 
da, ellei siitä peri maksua. Ohjelma ohjeineen löytyy ainakin Fred FISH -levyk- 
keeltä numero 58. 


Gurujen kertomaa 


Alert-ilmoitukset jakautuvat kolmeen pääryhmään. Ensimmäinen ryhmä muo- 
dostuu MC68000-prosessorin sisäisistä virheilmoituksista, kuten nollalla jako 
tai laiton käsky. Toisen ryhmän muodostavat Amigan käyttöjärjestelmän anta- 
mat virheilmoitukset, kuten muistin loppumisesta tiedottava alert. Kolmas ryh- 
mä ovat ohjelmien itsensä antamat alert-ilmoitukset, joita ohjelmissa voidaan 
käyttää vakavista virheistä tiedottamiseen. Tässä keskitytään vain kahden ensim- 
mäisen alert-tyypin käsittelyyn. 
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Käyttöjärjestelmän alert-laatikko sisältää aina kaksi heksadesimaalilukua, jot- 
ka ilmaisevat jotakin tapahtuneen virheen tyypistä. Vasemmanpuoleinen luku il- 
maisee virheen tyypin, oikeanpuoleinen tavallisesti virheen aiheuttaneen taskin 

(tehtävä, ohjelma) task-structuren osoitteen. Virheen tyyppi muodostuu kaavi- 
on mukaisesti kolmesta erillisestä kentästä, joita seuraa osoitekenttä d. Kentät a, 
b ja c yhdessä muodostavat alertin vasemman puoleisen luvun. 

00 00 0000 00000000 

ai 0D:n (€ d 

a — Kenttäailmaisee kirjaston tms., jossa virheen aiheuttanut rutiini sijaitsee. 
Mahdolliset arvot ovat seuraavat: 

00 — prosessorin oma virhe 

Kirjastot: 

01 — Exec.library 

02 — Graphics.library 
03 — Layers.library 

04 — Intuition.library 
05 — Math.library 

06 CList.library 

07 — Dos.library 

08 — Ram.library 

09 — Tcon.library 

0A — Expansion.library 

Devices: 

10 — audio.device (äänisofta) 
11 — console.device 
12 — gameport.device 
13 — keyboard.device 
14 — trackdisk.device (levyasema) 
15 — timer.device 
Resources: 
20 — 'cia.resource 
21 — disk.resource 
22 — misc.resource 

Muut: 

30 — bootstrap (boottiuravirhe) 
31 — workbench 
32 —diskcopy 
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Jos tapahtunut virhe on niin vakava, että se edellyttää välttämättä koneen uu- 
delleenkäynnistämistä, em. arvoihin on lisätty $80. Siten esimerkiksi Exec-kir- 
jaston ilmoitukseksi tulee 81. 

b Kenttäb ilmaisee virheen päätyypin. Jos virhe ei ole mitään seuraavista 
päätyypeistä, kentän b arvo on 00. 

01 Insufficient memory (muisti ei riitä) 
02 MakeLibrary error 

03 = OpenLibrary error 

04 —OpenDevice error 

05 = OpenResource error 

06 I/Oerror 

07  Nosignal 

c Kenttä c antaa tarkemman kuvauksen virheestä. Nämä arvot ovat 
kirjastokohtaisia (katso taulukko 1). 

d = Kenttäd sisältää tavallisesti virheen aiheuttaneen ohjelman task- 
structuren alkuosoitteen. 


Taulukko 1: Kirjastokohtaiset virhekoodit (kentät a, b ja c) 


Exec.library 


81000001 68000 exception vector checksum error 

81000002 execbase checksum error 

81000003 library checksum error 

81000004 no memory to make library 

81000005 corrupted memory list (muistin varauslista sekaisin) 
81000006 no memory for interrupt servers 

81000007 InitAptr 

81000008 semaphore corrupt 

81000009 free twice (sama muistialue vapautettu kahdesti) 
8100000A bogus exception 


Graphics.library 


82010001 no memory for Copper display list 
82010002 no memory for Copper instruction list 
82000003 Copper list overload 

82000004 Copper intermediate list overload 
82010005 no memory for copper list head 
82010006 long frame, no memory 

82010007 short frame, no memory 
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82010008 
82010009 
8201000A 
8201000B 
82010030 
82011234 


no memory for flood fill 
Text, no memory for TmpRas 
no memory for BItBitMap 
region memory 

MakeVPort 

GfxNoLCM 


Layers.library 


83010001 


LayersNoMem 


Intuition.library 


84000001 
84010002 
84010003 
84010004 
84010005 
84000006 
84010007 
84010008 
84000009 
8401000A 
8401000B 
8400000C 
8400000D 
8400000F 
8400000F 


Dos.library 


07010001 
07000002 
07000003 
07000004 
07000005 
07000006 
07000007 
07000008 
07000009 
0700000A 
0700000B 


unknown gadget type 

no memory to create port 

item plane alloc. no memory 

sub alloc. no memory 

plane alloc. no memory 

item box top less than RelZero 

no memory to open screen 

open screen, raster alloc. no memory 
open sys screen, unknown type 

add SW gadgets, no memory 

no memory to open window 

bad state return entering Intuition 
bad message received by IDCMP 
Weird message causing incomprehension 
couldn"t open the console device 


no memory at startup 
EndTask didn"t (didn"t what???) 
Opkt failure 

Unexpected packet received 
Freevec failed 

Disk block seguence error 
Bitmap corrupt 

Key already free 

Invalid checksum 

disk error 

Key out of range 
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Ram.library 
08000001 Bad segment list 


Expansion.library 
0A000001 Bad expansion free 
TrackDisk Device 
14000001 calibrate: seek error 
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14000002 Delay: error on timer wait 


Timer Device 


15000001 Bad reguest 
15000002 Bad supply 


Disk Resource 


21000001 Get unit: already has disk 
21000002 Interrupt: no active unit 


BootStrap 


30000001 Boot code returned an error 
Taulukko 2: 68000:n omat virheet (kentät a, b ja c jos a on 00) 


00000002 Bus error 
00000003 Address error 


00000004 


00000005 Divide by Zero 


00000006 CHK-instruction 
00000007 TRAPV-instruction 
00000008 Privilege violation 


00000009 Trace (single step) 
0000000A A-line emulator 
0000000B F-line emulator 


väylävirhe 

osoitevirhe: sanaa tai pitkää sanaa osoitettu 
parittomassa osoitteessa 

Illegal Instructionlaiton käsky: ohjelma 
harhautunut pois ohjelmakoodin alueelta 
nollalla jakaminen: DIVS- tai DIVU- 
käskylle annettu jakajaksi nolla 

CHK aiheuttanut exception-tilan 

TRAPV aiheuttanut exception- tilan 
yritetty suorittaa käyttäjän tilassa käsky, 
jonka voi suorittaa vain Supervisor-tilassa 
prosessori askellustilassa 

68000 ei tunne 1010-alkuisia käskyjä 
68000 ei tunne 1111-alkuisia käskyjä 
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Loppusanat 


Tämän kirjan tarkoitus ei ole ollut kertoa kaikkea Amigan ohjelmoinnista, se 
tuskin on mahdollista yhden kirjan puitteissa. Pyrkimyksenä on antaa perustie- 
dot assemblerohjelmien tekemisestä Amigaan sekä opettaa esimerkkien avulla 
käytännön ohjelmointia. 

Kirjan Liitteet-osassa ja mukana tulevalla levykkeellä on paljon erilaisia oh- 
jelmaesimerkkejä, joista osa on tehty erityisesti tätä kirjaa varten. Niissä on yksi- 
tyiskohtaiset selostukset toiminnasta ja niistä on pyritty tekemään mahdollisim- 
man selkeitä. Siksi useita ohjelmia voitaisiin lyhentää ja nopeuttaa jonkin ver- 
ran, mutta tällöin niiden ymmärrettävyys kärsisi. Osa levykkeen ohjelmista on 
"tavallista" koodia, jossa ei ole yhtä paljoa selostuksia kuin varsinaisissa esimer- 
keissä. Niitä tarkastelemalla voi kuitenkin oppia useiden käyttöjärjestelmärutii- 
nien käytön ja muita tärkeitä asioita. Assemblerohjelmoinnin voi oppia jopa il- 
man kirjallisuutta, jos käytettävissä on riittävästi selkeitä, monipuolisia esimerk- 
kejä. 

Kirjallisuusliitteessä (liite F) on lueteltu joitakin Amigan ohjelmoinnissa hyö- 
dyllisiä teoksia. Ne ovat kaikki englanninkielisiä, mutta niissä käytetty sanasto 
on melko suppea ja ahkeralla tutkimisella helposti opittavissa. Jossakin vaihees- 
sa innokas ohjelmoija joutuu joka tapauksessa turvautumaan ulkomaiseen kirjal- 
lisuuteen, koska suomenkielistä assemblerohjelmointia käsittelevää materiaalia 
on markkinoilla valitettavan vähän. 

Jossakin vaiheessa ohjelmoidessa tulee varmasti tilanne, jolloin ongelma ei 
ratkea omin avuin. Tällöin kannattaa kääntyä muiden Amigaa ohjelmoivien puo- 
leen, sillä useimmat ovat joutuneet painiskelemaan samojen ongelmien kanssa. 
Kannattaa myös antaa jonkun toisen vilkaista ohjelmaa, sillä itse tulee helposti 
sokeaksi omille virheilleen. Usein auttaa jo se, että selittää ohjelman toimintaa 
rivi riviltä jollekulle toiselle. Silloin huomaa helposti virheitä, jotka muuten ovat 
jääneet huomaamatta. 

Ohjelmoidessa kannattaa muistaa, että jokainen Amigaa ohjelmoiva on joutu- 
nut kulkemaan saman tien. Kukaan ei hallitse ohjelmointia syntyessään. 
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Liite A 
MC68000:n käskykanta 


T ässä liitteessä käydään yksityiskohtaisesti läpi kaikki MC68000:n käskyt ja niiden 
toiminnat. Tekstissä käytettyjen lyhenteiden merkitykset sekä MC68000:n osoitus- 
muodot on taulukoitu alla oleviin laatikoihin. 

Käskyissä oikeanpuoleinen parametri on kohde, vasemmanpuoleinen lähde. Käskyt, 
joihin kuuluu kaksi parametria, eivät vaikuta lähdeparametriin lukuunottamatta EXG-käs- 
kyä. On huomattava, että esimerkiksi SUB D1,D0 vähentää D0:n arvosta D1:n arvon ja 
sijoittaa tuloksen DO:aan (siis DO=D0-D 1 EIKÄ D0=D1-D0). 

Aina käskyn kohdeosoitetta laskettaessa kaikki osoitteeseen mahdollisesti liittyvät lu- 
vut (indeksirekisterin arvo, offset) tulkitaan etumerkillisinä. Tämä tarkoittaa sitä, että lu- 
ku on kahden komplemettimuodossa, jolloin esimerkiksi -1 = $ffffffff, -2 = Sfffffffe jne. 
Näin offset-arvojen avulla voidaan viitata sekä eteen- että taaksepäin. 8-bittisen offsetin 
arvo voi olla -128...127 ja 16- bittisen -32768...32767. 

Kun käytetään käskyjen 8- tai 16-bittisiä muotoja, kohteen ylemmät bitit säilyvät 
muuttumattomina. Niinpä esimerkiksi ADD.W 4100,DO lisää D0:n alimpien 16 bitin 
muodostamaan lukuun sata. Vaikka tulos vaatisi muistinumeron siirtämistä ylempiin 16 
bittiin, ne säilyvät ennallaan. 

Seuraavassa MC68000:n käskyt on esitelty aakkosjärjestyksessä. Käskyn nimen vie- 
ressä on käskyn englanninkielinen selostus, josta myös käskyn nimi johtuu sekä toiminta- 
kuvaus suomeksi. Sitten seuraa käskyn syntaksi, joka kertoo, miten käsky ja siihen liitty- 
vät parametrit kirjoitetaan kääntäjään. Mahdolliset osoitusmuodot ja toiminnon kokovaih- 
toehdot luetellaan ennen tilakooditaulukkoa. Lopuksi useimmista käskyistä annetaan vie- 
lä yksinkertainen esimerkki. 


Lyhenteet: 

An osoiterekisteri n (n = 0...7) 

CCR tilarekisteri (Condition Code Register) 
Dn datarekisteri n (n = 0...7) 

dst kohde (destination) 

d8 8 bitin displacement 

d16 16 bitin displacement 

<ea> todellinen osoite (effective address) 
PC ohjelmalaskuri (program counter) 

Rn data- tai osoiterekisteri n (n = 0...7) 
src lähde (source) 

SP pino-osoitin (Stack Pointer) 

SR statusrekisteri (Status Register) 

Xn data- tai osoiterekisteri n (n = 0...7) indeksirekisterinä 
xxx.L 32-bittinen absoluuttinen osoite 
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» 
>= 
x 
= 


Kam x Z2N<0O 


16-bittinen absoluuttinen osoite 

Carry-lippu 

Overflow-lippu (asettuu, jos tapahtui ylivuoto) 
Zero-lippu (asettuu, jos tulos on nolla) 

Negative-lippu (asettuu, jos tulos on negatiivinen) 
Extend-lippu 

käskyn toiminta on 8-bittinen (tavu eli byte) 

käskyn toiminta on 16-bittinen (sana eli word) 

käskyn toiminta on 32-bittinen (pitkä sana eli long word) 


Osoitusmuodot: 


Dn 


An 


-(An) 


d16(An) 


d8(An,Xn) 


xxx. W 
xxx.L 
tH<data> 


d16(pc) 


d8(pc,Xn) 


suora osoitus, kohteena datarekisteri. 

Esimerkki: MOVEO. L 40,D1 

suora osoitus, kohteena osoiterekisteri 

Esimerkki: MOVEA L H$dff000,A0 

epäsuora osoitus, kohteena osoiterekisterin ilmaisema muistiosoite 
Esimerkki: MOVE.B f1 (A0) 

epäsuora autoinkrementoiva osoitus, kohteena osoiterekisterin ilmaisema 
muistiosoite 
Esimerkki: MOVE.B (A0)+,D0 

epäsuora autodekrementoiva osoitus, kohteena osoiterekisterin ilmaisema 
muistiosoite 
Esimerkki: MOVE.B -(A3),-(A2) 

epäsuora osoitus 16 bitin offsetilla, kohteena osoiterekisterin ja offsetin 
summan ilmaisema muistiosoite 

Esimerkki: MOVE.W 11000,34(A0) 

epäsuora indeksoitu osoitus 8 bitin offsetilla, kohteena osoite- ja 
indeksirekisterien sekä offsetin summan ilmaisema muistiosoite 
Esimerkki: MOVE.W 41000,20(A0,D0.L) 

absoluuttinen suora osoitus, osoite 16 bittiä 

Esimerkki: MOVE.L 4,D0 

absoluuttinen suora osoitus, osoite 32 bittiä 

Esimerkki: MOVE.W H$fff $dff180 

välitön osoitus, lähteenä data 

Esimerkki: MOVE.L 4123456,D0 

suhteellinen osoitus 16 bitin offsetilla, lähteenä ohjelmalaskurin ja offsetin 
summan ilmaisema muistiosoite 

Esimerkki: MOVE.L 300(PC),D0 

suhteellinen indeksoitu osoitus 8 bitin offsetilla, lähteenä ohjelmalaskurin, 
offsetin ja indeksirekisterin summan ilmaisema muistiosoite 

Esimerkki: MOVE.W -48(PC,A0),D5 
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ABCD Add Binary Coded Decimal With Extend 


Lisää kohdeoperandiin lähdeoperandin käyttäen BCD- aritmetiikkaa. Operaatio on ai- 
na 8-bittinen eli käsittää kaksi BCD-numeroa. Jos X-lippu oli asettunut ennen käskyn suo- 
ritusta, tulokseen lisätään yksi (muistinumero). Jos tuloksena syntyy muistinumero, C ja 
X asettuvat ykkösiksi. 


Syntaksi: 
ABCD Dn,Dm 
ABCD -(An),-(Am) 
Tilakoodit: 
N ei määritelty 
Z asettuu, jos tulos on nolla 
V ei määritelty 
C asettuu, jos yhteenlaskussa syntyy muistinumero 
X asettuu, jos yhteenlaskussa syntyy muistinumero 
Esimerkki: 


Alussa D0=$12, D1=$63, X=1 
Käsky ABCDDI1,D0 
Lopussa D0=$76, D1=$63, X=0 


ADD Add Binary 


Lisää lähteen kohteeseen käyttäen binääriaritmetiikkaa. Tulos sijoitetaan kohteeseen. 
Operaatio on 8-, 16- tai 32- bittinen, Jos tuloksena syntyy muistinumero, X ja C asettuvat 
ykkösiksi. 


Syntaksi: 
ADD.s <eal>,Dn (<ea1>) + <Dn> -> <Dn> 
ADD.s Dn,<ea2> <Dn> + (<ea2>) -> (<ea2>) 
missä <eal> on 
* Dn * d16(An) * d16(pc) 


* An * d8(An Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ *xxx.L 


* (An) * H<data> 
ja <ea2> on 
Dn *dl6(An) d16(pc) 
An — * d8(An Xn) d8(pc,Xn) 


* (An) * xxx. W 

* (An)+ *xxx.L 

* (An) — t<data> 
ja .son .B,.W tai L 
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Tilakoodit: 
N asettuu, jos tulos negatiivinen 
Z asettuu, jos tulos on nolla 
V asettuu, jos tapahtui ylivuoto 
(0) asettuu, jos yhteenlaskussa syntyy muistinumero 
X asettuu, jos yhteenlaskussa syntyy muistinumero 
Esimerkki: 


Alussa D0=$12e82341, D1=$630041af 
Käsky ADD.LDI1,D0 
Lopussa D0=$75e864f0, D1=$630041af, X=0, Z=0, N=0 


.ADDA Add Address 


Lisää osoiterekisterin arvoon lähteen käyttäen binääriaritmetiikkaa. Operaatio on 16- 
tai 32-bittinen. Käsky ei vaikuta tilarekisterin lippuihin. 


Syntaksi: 

ADDA.s <ea>,An (<ea>) + <An> -> <An> 
missä <ea> on 

* Dn * d16(An) * d16(pc) 


* An * d8(An Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ *xxx.L 
* -(An) *f<data> 
ja .son W tai L 


Tilakoodit: 
N ei muutu 
Z ei muutu 
Vv ei muutu 
C ei muutu 
X ei muutu 
Esimerkki: 


Alussa A0=$00c03428 
Käsky WADDA.L 4$00010000,40 
Lopussa A0=$00c13428 


ADDI Add Immediate 


Lisää kohteen arvoon välittömän arvon käyttäen binääriaritmetiikkaa. Operaatio on 8-, 
16- tai 32- bittinen. Käskysanaa seuraa yksi tai kaksi tietosanaa riippuen operaation koos- 
ta (.L-operaatio vaatii kaksi sanaa eli neljä tavua välitöntä tietoa). Tilarekisterin liput aset- 
tuvat normaalisti. 

Syntaksi: 

ADDI.s 1<data>,<ea> <data> + (<ea>) -> (<ea>) 
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missä <ea> on 
* Dn * d16(An) d16(pc) 
An * d8(An,Xn) d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ *xxx.L 
* (An) = f<data> 
ja .son .B,.W tai L 


Tilakoodit: 
N asettuu, jos tulos negatiivinen 
Z asettuu, jos tulos on nolla 
V asettuu, jos tapahtui ylivuoto 
C asettuu, jos yhteenlaskussa syntyy muistinumero 
X asettuu, jos yhteenlaskussa syntyy muistinumero 
Esimerkki: 


Alussa D0=$12e82341 
Käsky WADDLW H$f234,D0 
Lopussa D0=$12e81575, X=1, C=1, V=0,Z=0, N=0 


1 


ADDO — Add Ouick 


Lisää käskykoodiin sisältyvän luvun kohteeseen käyttäen binääriaritmetiikkaa. Operaa- 
tio on 8-, 16- tai 32- bittinen paitsi kun kohteena on osoiterekisteri, jolloin 8-bittistä muo- 
toa ei voi käyttää. Lisättävä luku voi olla 1...8. Koska se sisältyy käskykoodiin, käskyyn 
ei liity muuta välitöntä tietoa ja käskyn suoritusaika on lyhyempi kuin vastaanavn AD- 
DI:n. Käsky soveltuu hyvin esimerkiksi silmukkalaskurien kasvattamiseen ja se korvaa 
useissa muissa prosessoreissa olevan INC-käskyn. Käsky muuttaa normaalisti tilarekiste- 
rin lippuja. 

Syntaksi: 

ADDO.s f<data>,<ea> <data> + (<ea>) -> (<ea>) 
missä <ea> on 

* Dn * d16(An) d16(pc) 

* An * d8(An Xn) d8(pc,Xn) 

* (An) * xxx. W 

* (An)+ *xxx.L 

* -(An) — f<data> 

ja .son .B,.W tai L 


Tilakoodit: 
N asettuu, jos tulos negatiivinen 
Z asettuu, jos tulos on nolla 
V asettuu, jos tapahtui ylivuoto 
c asettuu, jos yhteenlaskussa syntyy muistinumero 
X asettuu, jos yhteenlaskussa syntyy muistinumero 
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Esimerkki: 
Alussa D0=$12e82381 
Käsky WADDO.B 4$3,D0 
Lopussa D0=$12e82384, X=0, Z=0, N=1 


ADDX — Add Binary With Extend 


Lisää lähdeoperandin arvon kohteeseen käyttäen binääriaritmetiikkaa. Käsky ottaa 
huomioon myös extend- bitin (X-lipun) arvon, joten tätä käskyä käyttäen voidaan laskea 
yhteen yli 32-bittisiä lukuja. Tällöin edellisten lukujen yhteenlaskussa mahdollisesti syn- 
tynyt muistinumero huomioidaan myös. ADDX-käskystä on vain kaksi osoitusmuotoa. 
Käsky asettaa Z-, C- ja X-liput tulosta vastaaviksi. 
Syntaksi: 
ADDX.s Dsrc,Ddst <Dsrc> + <Ddst> + X -> <Ddst> 
ADDX s -(Asrc),-(Adst) 

missä .s on B,.W tai L 

Tilakoodit: 


N ei määritelty 

Z asettuu, jos tulos on nolla 

V ei määritelty 

(0 asettuu, jos yhteenlaskussa syntyy muistinumero 

X asettuu, jos yhteenlaskussa syntyy muistinumero 
Esimerkki: 


Alussa D0=$00000007, D1=$00000001, X=1 
Käsky ADDX.BDI1,D0 
Lopussa D0=$00000009, D1=$00000001, X=0, Z=0 


AND Logical AND 


AND muodostaa loogisen JA-toiminnon lähde- ja kohdeoperandien välille. Ainakin 
toisen operandin on oltava datarekisteri. Tilarekisterin liput asettuvat normaalisti. 
Syntaksi: 


AND.s <eal>,Dn (<ea1>) JA <Dn> -> <Dn> 

AND.s Dn,<ea2> <Dn> JA (<ea2>) -> (<ea2>) 
missä <eal> on 

* Dn * d16(An) * d16(pc) 


An * d8(An Xn) * d8(pc,Xn) 
* (An) —* xxx. W 

* (An)+ * xxx.L 

* (An) *t<data> 


ja <ea2> on 
Dn *dl6(An) d16(pc) 
An —* d8(An Xn) d8(pc,Xn) 


* (An) * xxx. W 
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* (An)+ *xxx.L 
* (An) F<data> 
ja .son .B, W tai L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V nollautuu 
c nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$27=%00100111, D1=$39=%00111001 
Käsky AND.BD0,DI 
Lopussa D0=$27=%00100111, D1=$21=%00100001 


ANDI AND Immediate 


Muodostaa kohteen ja välittömän luvun välillä loogisen JA-toiminnon. 
Syntaksi: ' 

ANDI:s f<data>,<ea> — <data> JA (<ea>) -> (<ea>) 
missä <ea> on 


* Dn * d16(An) d16(pc) 
An * d8(An,Xn) d8(pc,Xn) 
* (An) * xxx. W « 


* (An)+ *xxx.L 
* -(An) f<data> 
ja .son .B, W tai L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V nollautuu 
C nollautuu 
X ei muutu 
Esimerkki: 


Alussa  D0=$2375=%0010001101110101 
Käsky —ANDI.W 4$3f,D0 
Lopussa D0=$0035=%00000000001 10101 


ANDI to CCR AND Immediate Data To the Condition Codes 


Muodostaa tilarekisterin ja välittömän 8-bittisen luvun välillä loogisen JA-toiminnon 
sekä tallentaa tuloksen tilarekisteriin. Tällä käskyllä voidaan siis nollata halutut bitit tila- 
rekisterissä. 

Syntaksi: 

ANDI — <data>,CCR 
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Tilakoodit: 
N riippuu välittömän luvun bitistä 3 ja lipun entisestä tilasta 
Z riippuu välittömän luvun bitistä 2 ja lipun entisestä tilasta 
V riippuu välittömän luvun bitistä 1 ja lipun entisestä tilasta 
C riippuu välittömän luvun bitistä O ja lipun entisestä tilasta 
X riippuu välittömän luvun bitistä 4 ja lipun entisestä tilasta 


Jos tilabittiä vastaava bitti välittömässä luvussa on ykkönen, tilabitti ei muutu. Jos bitti 
on nolla, vastaava tilabitti nollautuu. 
Esimerkki: 
Alussa N=1,Z=0, V=1, C=1, X=1 
Käsky ANDI 4$ee,CCR 
Lopussa N=1,Z=0, V=1, C=0, X=0 


ANDI to SR — AND Immediate Data To the Status Register 


Muodostaa statusrekisterin ja välittömän 16-bittisen luvun välillä loogisen JA-toimin- 
non sekä tallentaa tuloksen statusrekisteriin. Tällä käskyllä voidaan siis nollata halutut bi- 
tit statusrekisterissä. Käsky voidaan suorittaa vain prosessorin supervisor- tilassa. Muuten 
se aiheuttaa gurun 8 (Privilege Violation). 


Syntaksi: 
ANDI —ff<data>,SR 

Tilakoodit: 
N riippuu välittömän luvun bitistä 3 ja lipun entisestä tilasta 
Z riippuu välittömän luvun bitistä 2 ja lipun entisestä tilasta 
V riippuu välittömän luvun bitistä 1 ja lipun entisestä tilasta 
(0 riippuu välittömän luvun bitistä O ja lipun entisestä tilasta 
X riippuu välittömän luvun bitistä 4 ja lipun entisestä tilasta 


Jos tilabittiä vastaava bitti välittömässä luvussa on ykkönen, tilabitti ei muutu. Jos bitti 
on nolla, vastaava tilabitti nollautuu. Käskyllä voidaan nollata myös Trace- (bitti 15), Su- 
pervisor- (bitti 13) ja Interrupt level- (bitit 8,9 ja 10) liput. 

Esimerkki: 

Alussa N=1,Z=0, V=1, C=1, X=1, T=0, S=1,1=%101 
Käsky ANDI 4$87ee,SR 
Lopussa N=1,Z=0, V=1, C=0, X=0, T=0, S=0,1=%101 


ASL ja ASR — Arithmetic Shift Left and Right 


Siirtää kohteen arvoa halutun bittimäärän vasemmalle tai oikealle. Määrä voi olla väli- 
tön luku tai datarekisterin arvo. Mikäli kohde on muisti, siirto on mahdollinen vain yhden 
bitin kerrallaan. Tällöin kohdeoperandin koko voi olla vain 16 bittiä. 

ASL siirtää operandin bittejä vasemmalle. Alimpaan bittiin siirretään nolla ja operan- 
dista pois siirtyvä bitti sijoitetaan C- ja X-lippuihin. 

ASR siirtää operandin bittejä oikealle. Ylin bitti monistuu ja alimmasta poistuva bitti 
menee C- ja X- lippuihin. 
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ASL kertoo operandia, ASR jakaa sitä. Esimerkiksi ASL.L 43,D0O kertoo datarekiste- 
rin O arvon kahdeksalla. ASR.L $1,D3 taas jakaa D3:n arvon kahdella. ASL- ja ASR-käs- 
kyjen käyttö kannattaa, jos luku on kerrottava tai jaettava jollakin 2:n potenssilla, sillä ne 
toimivat yksinkertaisuutensa vuoksi huomattavasti nopeammin kuin vastaavat kerto- ja ja- 
kolaskukäskyt (MUL ja DIV). 

" Aritmeettinen" käskyjen nimissä tarkoittaa, että käskyt kertovat ja jakavat myös etu- 
merkilliset, negatiiviset luvut matemaattisesti oikein. Jos operandia jaetaan ASR:lla, sen 
ylin bitti (eli luvun merkki) monistuu. Siten vain luvun itseisarvo muuttuu merkin pysyes- 
sä ennallaan. Vastaava looginen operaatio LSR siirtää operandin ylimpään bittiin nollan, 
jolloin sen merkki vaihtuu. 

Syntaksi: 

ASL.s Dn,Dm 
ASL.s —t<data>,Dn 
ASL <ea> 
ASR.s Dn,Dm 
ASR.s — ft<data>,Dn 


ASR <ea> 
missä <ea> on 
Dn *dl6(An) d16(pc) 
An —*d8(AnXn) d8(pc,Xn) 


* (An) * xxx. W 

* (An)+ * xxx.L 

* -(An) fH<data> 
ja.son .B, W tai L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V asettuu, jos operandin ylin bitti muuttui siirron aikana 
C asettuu viimeisen operandista siirretyn bitin mukaisesti 
X asettuu viimeisen operandista siirretyn bitin mukaisesti 
Esimerkki: 


Alussa D0=$12e82341 
Käsky ASL.L4,D0 
Lopussa D0=$2e823410 
Alussa D0=$87654321 
Käsky ASR.L 44,D0 
Lopussa D0=$f8765432 


Bcc Branch 


Ehdollinen, suhteellinen hyppy. Hypyn pituuden ilmaisee 8- tai 16-bittinen etumerkil- 
linen luku (offset). Hypyn kohdeosoite saadaan lisäämällä käskyn osoitteeseen 2 ja käs- 
kyyn kuuluvat offset. Välittömästi Bcc-käskyä seuraavaan osoitteeseen ei voi hypätä. Jos 
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käskyssä testattava ehto on tosi, hyppy em. kohdeosoitteeseen suoritetaan. Muuten ohjel- 
man suoritusta jatketaan käskyä seuraavasta osoitteesta. 
Bcc-käskyn mahdolliset ehdot ovat seuraavat: 


käsky = ehto testi 

BHI > /C JA /Z etumerkittömille luvuille 
BLS <= CTAIZ etumerkittömille luvuille 
BCC => C=0 etumerkittömille luvuille 
BCS < C=1 etumerkittömille luvuille 
BNE <> Z=0 kaikille luvuille 

BEO - Z=1 kaikille luvuille 

BVC V=0 

BVS V=1 

BPL >=0 N=0 

BMI <0 N=1 

BGE => etumerkillisille luvuille 
BLT < etumerkillisille luvuille 
BGT > etumerkillisille luvuille 
BLE << etumerkillisille luvuille 


BRA ehdoton, hyppy suoritetaan aina 

Tavallisesti ehdollisen hyppykäskyn parametriksi annetaan jokin lappu tai absoluutti- 
nen osoite, jolloin assembler-kääntäjä hoitaa varsinaisen offset-arvon laskemisen. 

Jotkut assemblerit hyväksyvät edellisten lisäksi muodot BLO ja BHS, jotka käännettä- 
essä muuntuvat käskyiksi BCS ja BCC. Ihmisen kannalta on helpompi muistaa kuvaan- 
nollisemmat muodot BLO (Branch if LOwer) ja BHS (Branch if Higher or Same). 

Tilakoodit: 


N ei muutu 

Z ei muutu 

Vv ei muutu 

(0) ei muutu 

X ei muutu 
Esimerkki: 

Alussa N=1 


Käsky BMI NEGATIIVINEN siirtää ohjelman 
suorituksen osoitteeseen "NEGATIIVINEN" 
Lopussa N=1 


BCHG (TestaBit and Change 


Testaa halutun bitin tilaa datarekisterissä tai muistissa ja vaihtaa ao. bitin tilan päinvas- 
taiseksi. Jos bitti oli nolla ennen käskyn suoritusta, Z-lippu asettuu ja bitti muuttuu ykkö- 
seksi. Jos taas bitti oli ykkönen, Z-lippu nollautuu ja bitti vaihdetaan nollaksi. Vaihdetta- 
va bitti voi olla datarekisterissä, jolloin käsky toimii 32-bittisenä, tai muistissa, jolloin 
käytettävissä on 8-bittinen muoto. Bitin numero voidaan ilmoittaa välittömällä luvulla tai 
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datarekisterin avulla. Bitin numero voi olla 0...7 tai 0...31 operandista riippuen. 
Syntaksi: 
BCHG.s Dn,<ea> 
BCHG.stt<data>,<ea> 
missä <ea> on 
* Dn * d16(An) d16(pc) 
An * d8(An,Xn) d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
* -(An) <data> 
ja .s on .B (kun <ea> on muisti) tai .L (kun <ea> on datarekisteri) 


Tilakoodit: 
N ei muutu 
Z asettuu, jos testattava bitti oli nolla (muuten nollautuu) 
V ei muutu 
C ei muutu 
X ei muutu 
Esimerkki: 


Alussa D0=$00000000=%00...0000 
Käsky BCHG.L 40,D0 
Lopussa D0=$00000001=%00...0001, Z=1 


BCLR Test a Bit and Clear 


Testaa halutun bitin tilaa datarekisterissä tai muistissa ja nollaa ao. bitin. Jos bitti oli 
nolla ennen käskyn suoritusta, Z-lippu asettuu, muuten Z-lippu nollautuu. Käskyn suori- 
tuksen jälkeen bitti on aina nolla. Nollattava bitti voi olla datarekisterissä, jolloin käsky 
toimii 32-bittisenä, tai muistissa, jolloin käytettävissä on 8-bittinen muoto. Bitin numero 
voidaan ilmoittaa välittömällä luvulla tai datarekisterin avulla. Bitin numero voi olla 0...7 
tai 0...31 operandista riippuen. 

Syntaksi: 

BCLR.s Dn,<ea> 
BCLR.s 4<data>,<ea> 


missä a on 
* Dn * d16(An) d16(pc) 
An * d8(An,Xn) d8(pc,Xn) 


* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) — f<data> 
ja .s on .B (kun <ea> on muisti) tai .L (kun <ea> on datarekisteri) 


Tilakoodit: 
N ei muutu 
Z asettuu, jos testattava bitti oli nolla (muuten nollautuu) 
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Vv ei muutu 

(0) ei muutu 

X ei muutu 
Esimerkki: 


Alussa D0=$00000001=%00...0001 
Käsky BCLR.L40,D0 
Lopussa D0=$00000000=%00...0000, Z=0 


BSET Test a Bit and Set 


Testaa halutun bitin tilaa datarekisterissä tai muistissa ja asettaa ao. bitin. Jos bitti oli 
nolla ennen käskyn suoritusta, Z-lippu asettuu, muuten Z-lippu nollautuu. Käskyn suori- 
tuksen jälkeen bitti on aina ykkönen. Asetettava bitti voi olla datarekisterissä, jolloin käs- 
ky toimii 32-bittisenä, tai muistissa, jolloin käytettävissä on 8-bittinen muoto. Bitin nume- 
ro voidaan ilmoittaa välittömällä luvulla tai datarekisterin avulla. Bitin numero voi olla 
0...7 tai 0...31 operandista riippuen. 

Syntaksi: 

BSET.s Dn,<ea> 
BSET.s f<data>,<ea> 


missä a on 
* Dn * d16(An) d16(pc) 
An * d8(An,Xn) d8(pc,Xn) 


* (An) * xxx. W 

* (An)+ *xxx.L 

* (An) — H<data> 
ja .s on .B (kun <ea> on muisti) tai .L (kun <ea> on datarekisteri) 
Tilakoodit: 


N ei muutu 
Z asettuu, jos testattava bitti oli nolla (muuten nollautuu) 
V ei muutu 
(0) ei muutu 
X ei muutu 
Esimerkki: 


Alussa D0=$00000001=%00...0001 
Käsky BSET.L431,D0 
Lopussa D0=$80000001=%10...0001, Z=1 


BSR Branch to Subroutine 


Kutsuu aliohjelmaa, jonka osoite on suhteellinen ohjelmalaskuriin (vastaa siis tässä 
suhteessa ehdollisia haarautumiskäskyjä). Käsky vastaa muuten JSR-käskyä, mutta käy- 
tettävissä on ainoastaan suhteellinen osoitusmuoto. Toiminta on seuraava: Aluksi proses- 
sori tallentaa BSR- käskyä seuraavan käskyn osoitteen pinomuistiin. Sitten se lisää BSR- 
käskyn operandin arvon ohjelmalaskuriin (BSR- käskyn osoite+2). Koska operandia käsi- 
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tellään etumerkillisenä lukuna, voi aliohjelma olla joko ennen tai jälkeen kutsuvan käs- 
kyn. 


Syntaksi: 
BSR lappu 
Tilakoodit: 
N ei muutu 
Z ei muutu 
V ei muutu 
C ei muutu 
X ei muutu 
Esimerkki: 


Käsky — BSR tulosta 
kutsuu tulosta-aliohjelmaa, jonka tulee päättyä RTS- käskyyn. 


BTST Test Bit 


Testaa halutun bitin tilaa datarekisterissä tai muistissa. Jos bitti oli nolla, Z-lippu aset- 
tuu, muuten Z-lippu nollautuu. Testattava bitti voi olla datarekisterissä, jolloin käsky toi- 
mii 32-bittisenä, tai muistissa, jolloin käytettävissä on 8-bittinen muoto. Bitin numero voi- 
daan ilmoittaa välittömällä luvulla tai datarekisterin avulla. Bitin numero voi olla 0...7 tai 
0...31 operandista riippuen. 

Syntaksi: 

BTST.s Dn,<ea> 
BTST.s f<data>,<ea> 


missä a on 
* Dn * d16(An) d16(pc) 
An * d8(An,Xn) d8(pc,Xn) 


* (An) * xxx. W 
* (An)+ *xxx.L 
* (An) —H<data> 
ja .s on .B (kun <ea> on muisti) tai .L (kun <ea> on datarekisteri) 


Tilakoodit: 
N ei muutu 
Z asettuu, jos testattava bitti oli nolla (muuten nollautuu) 
Vv ei muutu 
G ei muutu 
X ei muutu 
Esimerkki: 


Alussa D0=$f0000001=%111100...0001 
Käsky BTST.L H29,D0 
Lopussa D0=$f0000001=%111100...0001,Z=0 
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CHK Check Against Boundaries 


Vertaa datarekisterin arvoa lähdeoperandin arvoon. Jos rekisterin arvo on negatiivinen 
tai suurempi kuin lähdeoperandin arvo, prosessori hyppää exception-vektorin 6 (osoittees- 
sa $000018) kautta. Ellei käyttäjä ole asettanut vektoria omaan rutiiniinsa, tuloksena on 
guru. Käskystä on vain 16-bittinen muoto. 

Syntaksi: 

CHK.W <ea>,Dn 
missä <ea> on 
* Dn * d16(An) * d16(pc) 
An * A8(An,Xn) * d8(pc,Xn) 
* (An) * xxx W 
* (An)+ * xxx.L 
* (An) *H<data> 


Tilakoodit: 
N asettuu, jos Dn, nollautuu, jos Dnlähde, muuten ei määritelty 
Z ei määritelty 
V ei määritelty 
(0) ei määritelty 
X ei muutu 
Esimerkki: 


Alussa D0=$1500, D1=$1000 
Käsky CHK.W DI1,DO aiheuttaa hypyn exception-vektorin 6 kautta. 


CLR Clear an Operand 


Nollaa operandin (kirjoittaa operandiin nollan). 


Syntaksi: 

CLR.s —<ea> 0-> (<ea>) 
missä <ea> on 

* Dn * d16(An) d16(pc) 


An * d8(An,Xn) d8(pc,X'n) 
* (An) * xxx W 
* (An)+ * xxx,L 
* -(An) — H<data> 
ja .son .B, W tai L 


Tilakoodit: 
N nollautuu 
Zi asettuu 
Vv nollautuu 
C nollautuu 
X ei muutu 
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D0=$f5277ae6 
CLR.W DO 


Lopussa D0=$f5270000,Z=1 


CMP Compare 


Vähentää lähdeoperandin arvon datarekisterin arvosta ja asettaa tilakoodit tuloksen 
mukaisesti. Vastaa muuten vähennyslaskukäskyä (SUB), mutta CMP:ssä vähennyslaskun 
tulosta ei tallenneta. 


Syntaksi: 
CMP.:s —<ea>,Dn <Dn> - (<ea>) 
missä <ea> on 
* Dn * dl6(An) * d16(pc) 
* An * d8(An Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ *xxxL 
* -(An) * ft<data> 
ja .s on B,.W tai L 
Tilakoodit: 
N asettuu, jos — (a) 
Z asettuu, jos = (a) 
V asettuu, jos tapahtui ylivuoto 
C asettuu, jos vähennyslaskussa piti lainata 
X ei muutu 
Esimerkki: 
Alussa D0=$92e82341, X=0 
Käsky CMP.L4f0,D0 


Lopussa D0=$92e82341, X=0, Z=0, N=1, V=0, C=0 


CMPA — Compare Addresses 


Vähentää lähdeoperandin arvon osoiterekisterin arvosta ja asettaa tilakoodit tuloksen 
mukaisesti. Vastaa muuten vähennyslaskukäskyä (SUBA), mutta CMPA:ssä vähennyslas- 
kun tulosta ei tallenneta, mutta tilakoodit muuttuvat. 


Syntaksi: 

CMPA.s <ea>,An <An> - (<ea>) 
missä <ea> on 

* Dn * d16(An) * d16(pc) 

* An * d8(An, Xn) * d8(pc,Xn) 

* (An) * xxx. W 


* (An)+ * xxx.L 


* -(An) 


* H<data> 


ja .son W tai .L 
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Tilakoodit: 
N asettuu, jos <An> < (<ea>) 
Z asettuu, jos <An> = (<ea>) 
V asettuu, jos tapahtui ylivuoto 
€ asettuu, jos vähennyslaskussa piti lainata 
X ei muutu 
Esimerkki: 


Alussa A0=$00c02340, X=0 
Käsky CMPA.L4$00c0233e,A0 
Lopussa A0=$00c02340, X=0,7Z=0, N=0, V=0, C=0 


CMPI Compare Immediate 


Vähentää välittömän luvun kohdeparametrin arvosta ja asettaa tilakoodit tuloksen mu- 
kaisesti. Vastaa muuten vähennyslaskukäskyä (SUBI), mutta CMPI:ssä vähennyslaskun 
tulosta ei tallenneta. 

Syntaksi: 

CMPI:s ff<data>,<ea> (<ea>) - <data> 
missä <ea> on 

* Dn * d16(An) * d16(pc) 

An * d8(An Xn) * d8(pc,Xn) 

* (An) * xxx. W 

* (An)+ * xxx.L 

* (An) — F<data> 

ja .son .B, W tai L 


Tilakoodit: 
N asettuu, jos (<ea>) < <data> 
Z asettuu, jos (<ea>) = <data> 
V asettuu, jos (<ea>) - <data> aiheuttaa ylivuodon 
(0 asettuu, jos (<ea>) - <data> vaatii lainaamisen 
X ei muutu 

Esimerkki: 


Alussa D0=$92e82341, X=0 
Käsky CMPIL40,D0 
Lopussa D0=$92e82341, X=0, Z=0, N=1, V=0, C=0 


CMPM — Compare Memory 


Vertaa kahden muistipaikan sisältöä toisiinsa ja kasvattaa vertailun jälkeen käytettyjen 
osoiterekisterien arvoja. Osoiterekisterejä kasvatetaan 1:llä, 2:lla tai 4:llä riippuen käskyn 
muodosta (.B, W vai .L). Tätä käskyä käyttäen on helppoa vertailla esimerkiksi merkki- 
jonoja keskenään. 

Syntaksi: 

CMPM.:s (Asrc)+,(Adst)+ 
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missä .s on .B, W tai L 


Tilakoodit: 
N asettuu, jos (Adst) < (Asrc) 
Z asettuu, jos (Adst) = (Asrc) 
V asettuu, jos (Adst) - (Asrc) aiheuttaa ylivuodon 
C asettuu, jos (Adst) - (Asrc) vaatii lainaamista 
X ei muutu 

Esimerkki: 


Käsky CMPM.B (A0)+,/(A1)+ 
vertaa A0:n ja A1:n ilmaisemissa osoitteissa olevia tavuja keskenään ja asettaa 
Z-lipun, jos tavut olivat samat. Lopuksi osoiterekisterejä kasvatetaan ykkösellä. 


DBcce Test, Decrement, and Branch 


Aluksi käsky testaa tilakoodit. Jos ne toteuttavat käskyyn liittyvän ehdon (cc), ohjel- 
man suoritus jatkuu käskyä seuraavasta käskystä. Jos ehto ei toteutunut, pienennetään an- 
netun datarekisterin arvoa yhdellä. Jos tulos ei ole -1 (eli $ffff), suoritetaan hyppy annet- 
tuun suhteelliseen osoitteeseen. Jos datarekisterin arvo vähentämisen jälkeen oli -1, jatke- 
taan DBcc-käskyä seuraavasta käskystä. 

Prosessori siis hyppää annettuun osoitteeseen, jos: 

- annettu ehto cc ei toteudu, tai: 
- datarekisterin arvo vähentämisen jälkeen ei ole -1 

Ohjelman suoritus jatkuu seuraavasta käskystä, jos: 

- annettu ehto toteutui, TAI: 
- datarekisterin arvo vähentämisen jälkeen oli -1 

On huomattava, että DBcc pienentää datarekisterin arvoa vain 16-bittisenä. Siksi esi- 
merkiksi silmukoissa suurin toistokertojen määrä DBcc-käskyä käytettäesä on 65536. 

Käytettäessä DBF-käskyä ehto (false) ei toteudu ikinä, joten mahdollisuus poistua sil- 
mukasta on, että datarekisterin arvo menee -1:ksi. 

Kun DBNE-käskyä käytetään yhdessä CMPM-käskyn kanssa, voidaan vertailla merk- 
kijonoja erittäin nopeasti. 

DBcc-käskyn mahdolliset ehdot ovat seuraavat: 


käsky — ehto testi 

DBT true aina tosi 

DBF false aina epätosi 

DBHI > /C JA /Z etumerkittömille luvuille 
DBLS <= CTAIZ etumerkittömille luvuille 
DBCC => C=0 etumerkittömille luvuille 
DBCS < C=1 etumerkittömille luvuille 
DBNE <> Z= 

DBEO = Z=1 

DBVC vV=0 

DBVS V=1 
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DBPL >=0 N=0 
DBMI <0 N=1 
DBGE => etumerkillisille luvuille 
DBLT < etumerkillisille luvuille 
DBGT > etumerkillisille luvuille 
DBLE <= etumerkillisille luvuille 


DBT poistuu silmukasta heti yhden kierroksen jälkeen, DBF vasta, kun laskurin arvok- 
si tulee -1. 

Tavallisesti ehdollisen hyppykäskyn parametriksi annetaan jokin lappu tai absoluutti- 
nen osoite, jolloin assemblerkääntäjä hoitaa varsinaisen offset-arvon laskemisen. 

Jotkut assemblerit hyväksyvät edellisten lisäksi muodot DBLO ja DBHS, jotka kään- 
nettäessä muuntuvat käskyiksi DBCS ja DBCC. Ihmisen kannalta on helpompi muistaa 
kuvaannollisemmat muodot DBLO (Decrement and Branch it LOwer) ja DBHS (Decre- 
ment and Branch if Higher or Same). 


Tilakoodit: 
N ei muutu 
Z ei muutu 
Vv ei muutu 
C ei muutu 
X ei muutu 
Esimerkki: 
Alussa D0=$0007 
Käsky LOOP: DBF D0,LOOP toistaa silmukan 8 kertaa. 


Lopussa DO=$ffff 


DIVS Signed Divide 


Jakaa kohderekisterin 32-bittisen arvon 16-bittisellä lähdearvolla. 16-bittinen osamää- 
rä sijoitetaan kohderekisterin bitteihin 0...15 ja 16-bittinen jakojäännös bitteihin 16...31. 

Jaettava arvo (kohderekisteri) ja jakaja (lähderekisteri) ovat molemmat etumerkillisiä 
lukuja, samoin tulos. Jos osamäärä on suurempi kuin mitä 16 bitillä voidaan esittää, V-lip- 
pu asettuu. 

Jos jakaja on nolla, prosessori hyppää exception-vektorin 5 (osoitteessa $000014) 
kautta. Normaalisti tästä seuraa guru 00000005. 


Syntaksi: 

DIVS.W e<a>,Dn <Dn> / (<ea>) -> <Dn> 
missä <ea> on 

* Dn *dl16(An) * d16(pc) 


An * d8(An, Xn) * d8&(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) *f<data> 
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Tilakoodit: 
N asettuu, jos osamäärä on negatiivinen 
Z asettuu, jos osamäärä on nolla 
V asettuu, jos tapahtuu ylivuoto 
C nollautuu 
X ei muutu 


Jos jakolaskussa tapahtuu ylivuoto tai jos yritetään jakaa nollalla, N- ja Z-lippujen tilo- 
ja ei ole määritelty. 
Esimerkki: 
Alussa D0=$00000064=100 (dec.) 
Käsky DIVS.W t11,D0 
Lopussa D0=$00010009, Z=0, N=0, V=0, C=0 
Esimerkissä luku 100 jaettiin 11:llä. Tulos (9) sijoittui DO:n bitteihin 0...15 ja osamää- 
rä (1) bitteihin 16...31. 


DIVU Unsigned Divide 


Jakaa kohderekisterin 32-bittisen arvon 16-bittisellä lähdearvolla. 16-bittinen osamää- 
rä sijoitetaan kohderekisterin bitteihin 0...15 ja 16-bittinen jakojäännös bitteihin 16...31. 

Jaettava arvo (kohderekisteri) ja jakaja (lähderekisteri) ovat molemmat merkittömiä lu- 
kuja, samoin tulos. Jos osamäärä on suurempi kuin 16 bitillä voidaan esittää, V-lippu aset- 
tuu. Jos jakaja on nolla, prosessori hyppää exception-vektorin 5 (osoitteessa $000014) 
kautta. Normaalisti tästä seuraa guru 00000005. 


Syntaksi: 
DIVU.W <ea>,Dn <Dn> / (<ea>) -> <Dn> 
missä <ea> on 
* Dn * d16(An) * d16(pc) 


An * d8(An,Xn) * d8(pc,Xn) 
* (An) —* xxx. W 
* (An)+ * xxx.L 
* (An) *f<data> 


Tilakoodit: 
N asettuu, jos osamäärä on negatiivinen 
Z asettuu, jos osamäärä on nolla 
V asettuu, jos tapahtuu ylivuoto 
e nollautuu 
X ei muutu 


Jos jakolaskussa tapahtuu ylivuoto tai jos yritetään jakaa nollalla, N- ja Z-lippujen tilo- 
ja ei ole määritelty. 
Esimerkki: 
Alussa D0=$00000064=100 (dec.) 
Käsky DIVU.Wtf11,D0 
Lopussa D0=$00010009, Z=0, N=0, V=0, C=0 
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Esimerkissä luku 100 jaettiin 11:1lä. Tulos (9) sijoittui DO:n bitteihin 0...15 ja osamää- 
rä (1) bitteihin 16...31. 


EOR Exclusive OR 


EOR muodostaa ehdottoman TAI-toiminnon lähde- ja kohdeoperandien välillä. Aina- 
kin ensimmäisen operandin on oltava datarekisteri. Tilarekisterin liput asettuvat normaa- 
listi. 

Ehdoton tai -funktion tulos lasketaan vastinbiteittäin, kuten kaikkien loogisten operaa- 
tioiden. Jos vastinbittien tila on sama, tulos on nolla. Jos toinen ja vain toinen on ykkö- 
nen, tulos on ykkönen. 


Syntaksi: 

EOR.s Dn,<ea> <Dn> ETAI (<ea>) -> (<ea>) 
missä <ea> on 

* Dn * d16(An) d16(pc) 


An * d8(An,Xn) d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
* -(An) <data> 
ja .son .B,.W tai .L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V nollautuu 
(0) nollautuu 
X - ei muutu 
Esimerkki: 


Alussa D0=$27=%00100111, D1=$39=%00111001 
Käsky EOR.BD0,DI 
Lopussa D0=$27=%00100111, D1=$21=%00011110 


EORI Exclusive OR Immediate 


Muodostaa kohteen ja välittömän luvun välillä ehdottoman TAI-funktion. Ks. myös 
EOR. 

Syntaksi: 

EORI.s it<data>,<ea> — <data> ETAI (<ea>)->(<ea>) 
missä <ea> on 

* Dn * d16(An d16(pc) 

An * d8(An Xn) d8(pc,Xn) 

* (An) * xxx. W 

* (Am+ *xxx,L 

* (An) H<data> 
ja .son B,.W tai L 
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Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V nollautuu 
(6 nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$2375=%0010001101110101 
Käsky EORI.W f$3f,DO 
Lopussa D0=$234a=%0010001101001010 


EORI to CCR 
Exclusive OR Immediate Data To the Condition Codes 


Muodostaa tilarekisterin ja välittömän 8-bittisen luvun välillä ehdottoman TAI-toimin- 
non sekä tallentaa tuloksen tilarekisteriin. Tällä käskyllä voidaan siis vaihtaa haluttujen ti- 
larekisterin lippujen tila. 2 


Syntaksi: 
EORI — f<data>,CCR 

Tilakoodit: 
N riippuu välittömän luvun bitistä 3 ja lipun entisestä tilasta 
Z riippuu välittömän luvun bitistä 2 ja lipun entisestä tilasta 
V riippuu välittömän luvun bitistä 1 ja lipun entisestä tilasta 
C riippuu välittömän luvun bitistä O ja lipun entisestä tilasta 
X riippuu välittömän luvun bitistä 4 ja lipun entisestä tilasta 


Jos tilabittiä vastaava bitti välittömässä luvussa on ykkönen, tilabitin arvo vaihtuu yk- 
kösestä nollaksi tai päinvastoin. Jos bitti on nolla, vastaava tilabitti ei muutu. 
Esimerkki: 
Alussa N=1,Z=0, V=1,C=1, X=1 
Käsky EORI 4$01,CCR 
Lopussa N=1,Z=0, V=1, C=0, X=1 


EORI to SR 
Exclusive OR Immediate Data To the Status Register 


Muodostaa statusrekisterin ja välittömän 16-bittisen luvun välillä ehdottoman TAI-toi- 
minnon sekä tallentaa tuloksen statusrekisteriin. Tällä käskyllä voidaan siis vaihtaa halut- 
tujen tilarekisterin bittien tila päinvastaiseksi. Käsky voidaan suorittaa vain prosessorin 
supervisor- tilassa. Muuten se aiheuttaa gurun 8 (Privilege Violation). 

Syntaksi: 

EORI — %<data>,SR 


Tilakoodit: 
N riippuu välittömän luvun bitistä 3 ja lipun entisestä tilasta 
Z riippuu välittömän luvun bitistä 2 ja lipun entisestä tilasta 
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V riippuu välittömän luvun bitistä 1 ja lipun entisestä tilasta 
C riippuu välittömän luvun bitistä O ja lipun entisestä tilasta 
X riippuu välittömän luvun bitistä 4 ja lipun entisestä tilasta 


Jos tilabittiä vastaava bitti välittömässä luvussa on ykkönen, tilabitti vaihtuu ykkösestä 
nollaksi tai päinvastoin. Jos bitti on nolla, vastaava tilabitti ei muutu. 
Käskyllä voidaan vaihtaa myös Trace- (bitti 15), Supervisor- (bitti 13) ja Interrupt lev- 
el- (bitit 8,9 ja 10) lippujen tilat. 
Esimerkki: 
Alussa N=1,Z=0, V=1, C=1, X=1, T=0, S=1,1=%101 
Käsky —EORI 4$8000,SR 
Lopussa N=1,Z=0, V=1, C=1, X=1, T=1, S=1,1=%101 


EXG Exchange Registers 


Vaihtaa kahden prosessorin rekisterin sisällöt keskenään. Toiminta on aina 32-bittinen 
eli koko rekisterien sisällöt vaihtuvat. 


Syntaksi: 
EXG Rx,Ry 
missä Rx ja Ry ovat mitkä tahansa data- tai osoiterekisterit. 
Tilakoodit: 
N ei muutu 
Z ei muutu 
V ei muutu 
(0) ei muutu 
X ei muutu 
Esimerkki: 
Alussa D0=$12345678, A1=$23061988 
Käsky EXGD0,AI1 


Lopussa D0=$23061988, A1=$12345678 


EXT Sign Extend 


Muuttaa etumerkillisen 8-bittisen luvun 16-bittiseksi (EXT.W) tai 16-bittisen 32-bitti- 
seksi (EXT.L) luvun arvon säilyttäen. Käytännössä EXT kopioi alkuperäisen luvun ylintä 
bittiä (eli etumerkkiä) kaikkiin "uusiin bitteihin". 


Syntaksi: 
EXT.s Dn 
missä .s on W tai L 
Tilakoodit: 
N asettuu, jos tulos on negatiivinen 
Z asettuu, jos tulos on nolla 
V nollautuu 
C nollautuu 
DN ei muutu 
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Esimerkki: 
Alussa D0=$00000080 
Käsky EXT.W DO 
Lopussa D0=$0000ff80 


JMP Jump 


Aiheuttaa ehdottoman ohjelman suorituksen siirtymisen uuteen osoitteeseen, joka voi 
olla absoluuttinen tai suhteellinen ohjelmalaskuriin. JMP vastaa BRA-käskyä, mutta eri 
osoitusmuotojen määrä on suurempi. Käytännössä käsky lataa annetun osoitteen uudeksi 
ohjelmalaskurin arvoksi. 


Syntaksi: 
JMP <ea> <ea> -> PC 
missä <ea> on 
Dn *dl6(An) * d16(pc) 


An —* d8(An,Xn) * d8(pc,Xn) 
* (An) —* xxx. W 
(An)+ * xxx.L 
-(An) — t<data> 


Tilakoodit: 
N ei muutu 
JE ei muutu 
V ei muutu 
(0) ei muutu 
x ei muutu 
Esimerkki: 


Käsky JMP(A0) 
siirtää ohjelman suorituksen A0:n sisältämään osoitteeseen 


LEA Load Effective Address 


Laskee ohjelman suorituksen aikana tietyn kohteen sijaintiosoitteen ja sijoittaa tulok- 
sen annettuun osoiterekisteriin. Käskyn avulla voidaan (ohjelmalaskuriin suhteellista 
osoitusta käytettäessä) kirjoittaa ohjelmia, jotka voidaan sijoittaa vapaasti muistiin. 

Syntaksi: 


LEA <ea>,An <ea> -> An 
missä <ea> on 
Dn * d16(An) * d16(pc) 
An * d8(An Xn) *d8(pc,Xn) 


* (An) * xxx.W 
(An)+ * xxx.L 
-(An) tf<data> 

Tilakoodit: 
N ei muutu 
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Z ei muutu 
V ei muutu 
(0 ei muutu 
X ei muutu 
Esimerkki: 
Ohjelmassa on taulukko nimeltä TAUL, jonka alkuosoite halutaan osoiterekisteriin 


AO: 
Käsky LEA TAUL(PC),A0 
ottaa taulukon alkuosoitteen A0:aan 
Koska käsky käyttää suhteellista osoitusmuotoa, ei toiminta riipu ohjelman sijoittumi- 
sesta muistiin. 


LINK Link and Allocate Space 


Tallentaa annetun osoiterekisterin sisällön pinomuistiin, siirtää uuden pino-osoittimen 
arvon osoiterekisteriin ja lisää 16-bittisen välittömän, etumerkillisen arvon pino- osoitti- 
meen. 

Käskyä käytetään varattaessa pinomuistista tilaa esimerkiksi aliohjelman työalueeksi. 
Jos aliohjelma kutsuu itseään, se varaa jälleen uuden työalueen eikä käytä äskeistä aluetta 
sotkien sinne jo tallennettuja tietoja. Käskyssä käytetty osoiterekisteri osoittaa käskyn 
suorittamisen jälkeen varattua aluetta seuraavaan osoitteeseen (joka siis ei kuulu varat- 
tuun alueeseen). 

Tämän osoitteen alapuolella sijaitsee varattu osa pinomuistista, jonka koon tavuina 
määrää käskyyn kuuluva välitön luku. LINK-käskyllä varattu muisti vapautetaan ennen 
aliohjelmasta poistumista UNLK-käskyllä. 


|Varatsu alue 


Paluuosoite SP »-> 588) Paluuosoite 


vinen. Koska pino-osoittimen on pysyttävä parillisena, on aina varattava parillinen määrä 
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tavuja. Pinomuistin koko on rajallinen (normaalisti AmigaDOS varaa ohjelmalle 4000 ta- 
vua pinoa), ei työalue voi olla kovin suuri. 

Työalueen osoittamiseen käytettävän osoierekisterin arvon on oltava ennalkaan siinä 
vaiheessa, kun suoritetaan LINK- käskyä vastaava UNLK. 


Syntaksi: 

LINK — An,f<data> 
Tilakoodit: 

N ei muutu 

Z ei muutu 

Vv ei muutu 

C ei muutu 

X ei muutu 
Esimerkki: 


Varataan aliohjelman työalueeksi 32 tavua muistia: 
Käsky LINK AS5.H32 
Nyt A5:n ilmoittaman osoitteen alapuolella on 32 tavua pinomuistista varattua tilaa. 
Pino-osoitin osoittaa ensimmäiseen näistä tavuista, A5 viimeistä seuraavaan. 
Käsky UNIKAS vapauttaa varatun muistin. 


LSL ja LSR — Logical Shift Left and Right 


Siirtää kohteen arvoa halutun bittimäärän vasemmalle tai oikealle. Määrä voi olla väli- 
tön luku tai datarekisterin arvo. Mikäli kohde on muisti, siirto on mahdollinen vain yhden 
bitin kerrallaan. Tällöin kohdeoperandin koko voi olla vain 16 bittiä. LSL siirtää operan- 
din bittejä vasemmalle. Alimpaan bittiin siirretään nolla ja operandista pois siirtyvä bitti 
sijoitetaan C- ja X-lippuihin. 

LSR siirtää operandin bittejä oikealle. Ylimpään bittiin siirretään nolla ja alimmasta 
poistuva bitti menee C- ja X-lippuihin. 

LSL kertoo operandia, LSR jakaa sitä. Esimerkiksi LSL.L £3,DO kertoo datarekisterin 
0 arvon kahdeksalla. LSR.L $1,D3 taas jakaa D3:n arvon kahdella. LSL- ja LSR-käsky- 
jen käyttö kannattaa, jos luku on kerrottava tai jaettava jollakin 2:n potenssilla, sillä ne 
toimivat yksinkertaisuutensa vuoksi huomattavasti nopeammin kuin vastaavat kerto- ja ja- 
kolaskukäskyt (MUL ja DIV). 

"Looginen" käskyjen nimissä tarkoittaa, että käskyt siirtävät lukua oikealle tai vasem- 
malle samalla tavalla riippumatta sen etumerkistä. Siksi negatiivisen luvun jakaminen ei 
ole mahdollista LSR-käskyllä (ylimpään bittiin tulee nolla ja luku muuttuu positiiviseksi). 

Syntaksi: 

LSL.s DnDm 
LSL.s —H<data>,Dn 


LSL <ea> 

LSR.s DnDm 
LSR.s —f<data>,Dn 
LSR <ea> 
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missä <ea> on 
Dn * d16(An) d16(pc) 
An * d8(An,Xn) d8(pc,Xn) 
* (An) * xxx W 
* (An)+ * xxx.L 
* (An) —H<data> 
ja .son .B, W tai L 


Tilakoodit: 

N asettuu, jos tuloksen ylin bitti on ykkönen 

Z asettuu, jos tulos on nolla 

V nollautuu 

C asettuu viimeisen operandista siirretyn bitin mukaisesti 

X asettuu viimeisen operandista siirretyn bitin mukaisesti 
C- ja X-liput nollautuvat, jos operandia siirrettiin nolla kertaa. 
Esimerkki: 


Alussa D0=$f2e82341 
Käsky LSR.Lf8,D0 
Lopussa D0=$00f2e823 


MOVE Move Data 


MOVE siirtää lähdeparametrin arvon kohdeparametriin ja asettaa tilakoodit siirretyn 
luvun mukaisesti. Jos <ea1> on osoiterekisteri, voidaan käyttää ainoastaan 16- ja 32-bitti- 
siä muotoja. 


Syntaksi: 

MOVE s <ea1>,<ea2> (<eal>)->(<ea2>) 
missä <eal> on 

* Dn * d16(An) * d16(pc) 


* An * d8(An Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) * H<data> 
ja <ea2> on 
* Dn * d16(An) d16(pc) 
An * d8(An, Xn) d8(pc,Xn) 
* (An) —* xxx. W 
* (An)+ * xxx.L 
* (An) — H<data> 
ja .son B, .W tai L 


Tilakoodit: 
N asettuu, jos siirretty luku oli negatiivinen 
Z asettuu, jos siirretty luku oli nolla 
V nollautuu 
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C nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$24061988, D1=$00422139 
Käsky MOVE.LD0,DI 
Lopussa D0=$24061988, D1=$24061988 


MOVEA Move to Address Register 


MOVEA siirtää lähdeparametrin arvon osoiterekisteriin. Se eroaa tavallisesta MOVE- 
käskystä siinä, että kohteena on aina osoiterekisteri. Osoiterekisterin koko arvo muuttuu 
riippumatta siitä, käytetäänkö 16- vai 32-bittistä muotoa. Toinen eroavuus on, etteivät ti- 
larekisterin liput muutu MOVEA-käskyn suorituksen seurauksena. 

Useimmat assmebler-kääntäjät korvaavat automaattisesti MOVE-käskyn MOVEA- 
käskyllä, jos kohteena on osoiterekisteri. 


Syntaksi: 
MOVEA.s <ea> An (<ea>) -> <An> 
missä <ea> on 
* Dn * d16(An) * d16(pc) 


* An * d8(An, Xn) * d8(pc,Xn) 
* (An) —* xxx. W 

* (An)+ * xxx.L 

* (An) *f<data> 

ja .son W tai L 


Tilakoodit: 
N ei muutu 
Z ei muutu 
V ei muutu 
c ei muutu 
X ei muutu 
Esimerkki: 


Ladataan osoiterekisteriin värirekisterin O osoite: 
Käsky "MOVEA LiS$dff180,A0 
Lopussa A0=$00dff180 


MOVE to CCR 
Move To the Condition Codes 


Siirtää lähdeparametrin 8-bittisen arvon tilarekisteriin. Tällä käskyllä voidaan siis aset- 
taa tilarekisterin bitit haluttuun tilaan. 
Syntaksi: 
MOVE <ea>,CCR 
missä <ea> on 
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* Dn * d16(An) * d16(pc) 
An * d8(An,Xn) * d8(pc,Xn) 

* (An) —* xxx. W 

* (An)+ * xxx.L 

* (An) * f<data> 


Tilakoodit: 
N lähdeparametrin bitti 3 
Z lähdeparametrin bitti 2 
V lähdeparametrin bitti 1 
C lähdeparametrin bitti O 
X lähdeparametrin bitti 4 


Jos tilabittiä vastaava bitti välittömässä luvussa on ykkönen, tilabitti asettuu. Jos bitti 
on nolla, vastaava tilabitti nollautuu. 
Esimerkki: 
Alussa N=1,Z=0, V=1,C=1,X=1 
Käsky MOVE t$00,CCR 
Lopussa N=0,Z=0, V=0, C=0, X=0 


MOVE Frm SR 
Move From the Status Register 


Kopioi 16-bittisen statusrekisterin arvon annettuun kohteeseen. 
Syntaksi: 

MOVE SR,<ea> 
missä <ea> on 

* Dn * d16(An) d16(pc) 

An * d8(An,Xn) d8(pc,Xn) 

* (An) —* xxx. W 

* (An)+ * xxx.L 

* (An) f<data> 


Tilakoodit: 
N ei muutu 
Z ei muutu 
Vv ei muutu 
C ei muutu 
X ei muutu 
Esimerkki: 


Alussa N=1,Z=0, V=1, C=1, X=1, T=0, S=1,1=%101 
Käsky MOVESR,D0 
Lopussa D0=%0010010100011011 
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MOVE to SR 
Move to the Status Register 


Kopioi 16-bittisen lähdeparametrin arvon statusrekisteriin. Käskyn voi suorittaa vain 
Supervisor-tilassa, muutoin se aiheuttaa gurun 8. 
Syntaksi: 
MOVE <ea>,SR 
missä <ea> on 
* Dn * d16(An) * d16(pc) 
An * d8(An Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) * t<data> 


Tilakoodit: 
N lähdeparametrin bitti 3 
Z lähdeparametrin bitti 2 
V lähdeparametrin bitti 1 
(0 lähdeparametrin bitti 0 
X lähdeparametrin bitti 4 
Esimerkki: 


Alussa N=1,Z=0, V=1, C=1, X=1, T=0, S=1,1=%101 
Käsky MOVE f$0000,SR 
Lopussa N=0, Z=0, V=0, C=0, X=0, T=0, S=0, 1=%000 


MOVE USP 
Move to/from the User Stack Pointer 


Kopioi käyttäjän pino-osoittimen arvon kohdeparametriin tai päinvastoin. Kohde voi 
olla mikä tahansa osoiterekisteri. Käskyn voi suorittaa vain Supervisor-tilassa, muutoin 
se aiheuttaa gurun 8. 

Kaikki 68000-sarjan prosessorit sisältävät erilliset pino- osoittimet Supervisor-tilaa ja 
käyttäjän tilaa varten. Tämän käskyn avulla voidaan Supervisor-tilassa selvittää, missä 
käyttäjän pino sijaitsee ja asettaa pino-osoittimen arvo. 

Syntaksi: 

MOVE USP,An 
MOVE An,USP 


Tilakoodit: 
N ei muutu 
Z ei muutu 
V ei muutu 
c ei muutu 
X ei muutu 
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Esimerkki: 
Käsky MOVEA3,USP asettaa käyttäjän pino- 
osoittimen arvoksi A3:ssa olleen luvun 


MOVEM Move Multiple Registers 


Tallentaa yhden tai useamman prosessorin rekisterin arvon peräkkäisiin muistipaikkoi- 
hin tai pinoon. Vastakkainen toiminta hakee rekisterien arvot muistipaikoista tai pinosta. 
Tätä käskyä käytetään tallennettaessa rekisterien arvot pinomuistiin esimerkiksi aliohjel- 
mien alussa. Näin voidaan useita rekisterejä tallentaa yhdellä käskyllä. 

Esimerkiksi Amigan makroassembler sallii seuraavien merkintöjen käytön: 

MOVEM.L D0-D3/A0-A3,-(sp) 
MOVEM.L (sp)+,D0-D3/A0-A3 

Ensimmäinen esimerkki tallentaa rekisterit DO, D1, D2, D3, AO, A1, A2 ja A3 pino- 

muistiin (sp vastaa A7:ää) ja jälkimmäinen ottaa niiden arvot pinosta. 


Syntaksi: 
MOVEM.s H<data>,<ea1> 
MOVEM.s <ea2>,tt<data>, missä .son W tai L 


missä <eal> on 


Dn * d16(An) d16(pc) 
An * d8(An, Xn) d8(pc,Xn) 
* (An) * xxx. W 
(An)+ * xxx.L 
* (An) —t<data> 
ja <ea2> on 
'* > Dn *dl6(An) * dl6(pc) 
An — * d8(An,Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
-(An) t<data> 
Tilakoodit: 
N * ei muutu 
Z ei muutu 
Vv ei muutu 
(6 ei muutu 
X ei muutu 
Esimerkki: 
Käsky MOVEMLD0/D1/A0-A3,-(A7) 
tallentaa rekisterit DO, D1, AO, A1, A2 ja A3 pinomuistiin 


MOVEP Move Peripheral Data 


MOVED siirtää tietoa datarekisterin ja muistin (tavallisesti I/O-piirien) välillä. Rekiste- 
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rin eniten merkitsevä tavu siirretään ensin, vähiten merkitsevä viimeiseksi. I/O-piirin re- 
kKisterien on kaikkien sijaittava joko parillisissa tai parittomissa osoitteissa ja niiden on 
siis oltava 8-bittisiä. N 


Syntaksi: 
MOVEP.s Dn d8(An) 
MOVEP.s d8(An),Dn 
missä .s on .W tai L 
Tilakoodit: 
N ei muutu 
Z ei muutu 
V ei muutu 
[0] ei muutu 
X ei muutu 
Esimerkki: 


Siirretään DO:n arvo I/O-piirin kahteen 8-bittiseen rekisteriin, jotka ovat osoitteissa 6 
ja 8 (laskettuna I/O- piirin alkuosoitteesta). I/O-piirin alkuosoite on A0:ssa. 
Käsky "MOVEP.W D0,6(A0) 


MOVEO Move Ouick 


MOVEG siirtää välittömän etumerkillisen 8-bittisen luvun datarekisteriin. Vaikka läh- 
deparametri onkin 8-bittinen, datarekisterin kaikki bitit asetetaan. Lukua siirrettäessä se 
nimittäin laajennetaan 32-bittiseksi ylintä bittiä monistaen. 

Siirrettävä luku voi olla -128...127. 


Syntaksi: 
MOVEO f<data>,Dn <data> -> Dn 
Tilakoodit: 
N asettuu, jos siirretty luku oli negatiivinen 
Z asettuu, jos siirretty luku oli nolla 
V nollautuu 
0) nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$30061988 
Käsky MOVEO4-1,D0 
Lopussa DO=S$ffffffff, N=1, Z=0, V=0, C=0 


MULS — Signed Multiply 


Kertoo kohderekisterin 16-bittisen arvon 16-bittisellä lähdearvolla. 32-bittinen tulos si- 
joitetaan kohderekisteriin. 

Kerrottava (kohderekisteri) ja kertoja (lähderekisteri) ovat molemmat etumerkillisiä lu- 
kuja, samoin tulo. 
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Syntaksi: 
MULS.W <ea>,Dn <Dn> * (<ea>) -> <Dn> 
missä <ea> on 
* Dn * d16(An) * d16(pc) 


An * d8(An Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An) * xxx.L 
* (An) * f<data> 


Tilakoodit: 
N asettuu, jos tulo on negatiivinen 
Z asettuu, jos tulo on nolla 
V nollautuu (asettuu, jos tapahtuu ylivuoto) 
C nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$00000004 
Käsky MULS.W4$11,D0 
Lopussa D0=$00000044, Z=0, N=0, V=0, C=0 


MULU — Unsigned Multiply 


Kertoo kohderekisterin 16-bittisen arvon 16-bittisellä lähdearvolla. 32-bittinen tulos si- 
joitetaan kohderekisteriin. 

Kerrottava (kohderekisteri) ja kertoja (lähderekisteri) ovat molemmat merkittömiä lu- 
kuja, samoin tulo. 


Syntaksi: 

MULU.W <ea>,Dn <Dn> * (<ea>) -> <Dn> 
missä <ea> on 

* Dn * d16(An) * d16(pc) 


An * d8(An,Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) * t<data> 


Tilakoodit: 
N asettuu, jos tulon ylin bitti asettuu 
Z asettuu, jos tulo on nolla 
V nollautuu (asettuu, jos tapahtuu ylivuoto) 
(0 nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$0000000a=10 (dec.) 
Käsky WMULU.WfI1 DO 
Lopussa D0=$0000006€e=1 10, Z=0, N=0, V=0, C=0 
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NBCD Negate Decimal With Extend 


Vähentää kohteen arvon ja X-lipun nollasta ja sijoittaa tuloksen kohteeseen. Laskutoi- 
mituksessa käytetään BCD-aritmetiikkaa. 


Syntaksi: 

NBCD <ea> 0-X-(<ea>) -> (<ea>) 
missä <ea> on 

* Dn * d16(An) d16(pc) 


An * d8(An,Xn) d8(pc,Xn) 
* (An) —* xxx. W 
* (An)+ *xxx.L 
* (An) — <data> 


Tilakoodit: 
N ei määritelty 
Z asettuu, jos tulos on nolla 
V ei määritelty 
C asettuu, jos piti lainata 
X asettuu, jos piti lainata 
Esimerkki: 


Alussa D0=$00000034, X=1 
Käsky NBCDD0 
Lopussa D0=$00000065, Z=0, C=1, X=1 


NEG Negate 


Vähentää kohteen arvon nollasta ja sijoittaa tuloksen kohteeseen. Laskutoimituksessa 
käytetään binääriaritmetiikkaa. 


Syntaksi: 

NEG.s —<ea> 0-(<ea>) -> (<ea>) 
missä <ea> on 

* Dn * d16(An) d16(pc) 


An * d8(An Xn) d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ *xxx.L 
* (An) f<data> 
ja .son .B, W tai L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V asettuu, jos tapahtui ylivuoto 
c asettuu, jos piti lainata 
X asettuu, jos piti lainata 
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Esimerkki: 
Alussa D0=$12345678 
Käsky NEG.WD0 
Lopussa D0=$1234a988, N=1,Z=0, V=0, C=1, X=1 


NEGX Negate 


Vähentää kohteen arvon ja X-lipun nollasta ja sijoittaa tuloksen kohteeseen. Laskutoi- 
mituksessa käytetään binääriaritmetiikkaa. 


Syntaksi: 
NEG <ea> 0-X-(<ea>)->(<ea>) 
missä <ea> on 
* Dn * d16(An) d16(pc) 
An * d8(An Xn) d8(pc,Xn) 


* (An) * xxx.W 
* (An)+ * xxx.L 
* (An) — 4<data> 
ja .son .B, W tai L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V asettuu, jos tapahtui ylivuoto 
C asettuu, jos piti lainata 
X asettuu, jos piti lainata 
Esimerkki: 


Alussa D0=$12345678, X=1 
Käsky NEGX.WD0 
Lopussa D0=$1234a987, N=1,Z=0, V=0, C=1, X=1 


NOP No Operation 


Ei tee mitään. NOP-käskyä voidaan käyttää esimerkiksi lyhyiden viiveiden muodosta- 
miseen (sen suoritus kestää neljä kellojaksoa). Normaalisti suoritusaika on siis n. 0,56 us 


(mikrosekuntia). 
Syntaksi: 
NOP 
Tilakoodit: 
N ei muutu 
Z ei muutu 
V ei muutu 
C ei muutu 
X ei muutu 
Esimerkki: 
Käsky NOP aiheuttaa 0,56 us viiveen 
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NOT Logical Complement 


Vaihtaa kohteen kaikkien bittien tilat päinvastaiseksi. 


Syntaksi: 
NOT.s —<ea> 
missä <ea> on 
* Dn * d16(An) d16(pc) 


An * d8(An, Xn) d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx,L 
* (An) — H<data> 
ja .s on .B, W tai L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V nollautuu 
C nollautuu 
X ei muutu 


Alussa D0=$12345678 
Käsky NOT.LD0 
Lopussa DO=$edcba987, N=1, Z=0, V=0, C=0 


OR Logical Inclusive OR 


OR muodostaa loogisen TAI-toiminnon lähde- ja kohdeoperandien välille. Ainakin toi- 
sen operandin on oltava datarekisteri. Tilarekisterin liput asettuvat normaalisti. 


Syntaksi: 
OR.s <eal>,Dn (<ea1>) TAI <Dn> -> <Dn> 
OR.s Dn,<ea2> <Dn> TAI (<ea2>) -> (<ea2>) 
missä <eal> on 
* Dn * d16(An) * d16(pc) 


An * d8(An Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
* -(An) *t<data> 
ja <ea2> on 
Dn * d16(An) d16(pc) 
An * d8(An Xn) d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ *xxx.L 
* -(An) — H<data> 
ja .son B,.W tai L 
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Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
Vv nollautuu 
c nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$27=%00100111, D1=$39=%00111001 
Käsky OR.BDO0,DI 
Lopussa D0=$27=%00100111, D1=$3f=%00111111 


ORI —Inclusive OR Immediate 


Muodostaa kohteen ja välittömän luvun välillä loogisen TAI- toiminnon. 
Syntaksi: 

ORIs — f<data>,<ea> <data> TAI (<ea>)-> (<ea>) 
missä <ea> on 

* Dn * d16(An) 16(pc) 

An * d8(An Xn) d8(pc,Xn) 

* (An) * xxx. W 

* (An)+ * xxx.L 

* (An) = f<data> 
ja .son B, W tai L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V nollautuu 
C nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$2375=%0010001101110101 
Käsky —ORI.W H$f00f,DO 
Lopussa D0=$f37f=%1111001101111111, N=1,Z=0, V=0, C=0 


ORI to CCR 
Inclusive OR Immediate Data To the Condition Codes 


Muodostaa tilarekisterin ja välittömän 8-bittisen luvun välillä loogisen TAI-toiminnon 
sekä tallentaa tuloksen tilarekisteriin. Tällä käskyllä voidaan siis asettaa halutut bitit tila- 
rekisterissä. 


Syntaksi: 
ORI H<data>,CCR 
Tilakoodit: 
N riippuu välittömän luvun bitistä 3 ja lipun entisestä tilasta 
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riippuu välittömän luvun bitistä 2 ja lipun entisestä tilasta 
riippuu välittömän luvun bitistä 1 ja lipun entisestä tilasta 
riippuu välittömän luvun bitistä O ja lipun entisestä tilasta 
riippuu välittömän luvun bitistä 4 ja lipun entisestä tilasta 
Jos tilabittiä vastaava bitti välittömässä luvussa on ykkönen, tilabitti asettuu. Jos bitti 
on nolla, vastaava tilabitti ei muutu. 
Esimerkki: 
Alussa N=0,Z=0, V=0, C=0, X=0 
Käsky ORI 1$03,CCR 
Lopussa N=0,Z=0, V=1, C=1, X=0 


x O<N 


ORI to SR 
Inclusive OR Immediate Data To the Status Register 


Muodostaa statusrekisterin ja välittömän 16-bittisen luvun välillä loogisen TAI-toimin- 
non sekä tallentaa tuloksen statusrekisteriin. Tällä käskyllä voidaan siis asettaa halutut bi- 
tit statusrekisterissä. Käsky voidaan suorittaa vain prosessorin Supervisor- tilassa. Muu- 
ten se aiheuttaa gurun 8 (Privilege Violation). 

Syntaksi: 

ORI H<data>,SR 


Tilakoodit: 
N riippuu välittömän luvun bitistä 3 ja lipun entisestä tilasta 
Z riippuu välittömän luvun bitistä 2 ja lipun entisestä tilasta 
V riippuu välittömän luvun bitistä 1 ja lipun entisestä tilasta 
C riippuu välittömän luvun bitistä O ja lipun entisestä tilasta 
X riippuu välittömän luvun bitistä 4 ja lipun entisestä tilasta 


Jos tilabittiä vastaava bitti välittömässä luvussa on ykkönen, tilabitti asettuu. Jos bitti 
on nolla, vastaava tilabitti ei muutu. 
Käskyllä voidaan asettaa myös Trace- (bitti 15), Supervisor- (bitti 13) ja Interrupt lev- 
el- (bitit 8,9 ja 10) liput. 
Esimerkki: 
Alussa N=0,Z=0, V=0, C=0, X=0, T=0, S=0, 1=%000 
Käsky ORI 4$0601,SR 
Lopussa N=0,Z=0, V=0, C=1, X=0, T=0, S=0, 1=%110 


PEA Push Effective Address 


Laskee ohjelman suorituksen aikana tietyn kohteen sijaintiosoitteen ja sijoittaa tulok- 
sen pinomuistiin. Käskyn avulla voidaan (ohjelmalaskuriin suhteellista osoitusta käytettä- 
essä) kirjoittaa ohjelmia, jotka voidaan sijoittaa vapaasti muistiin. 

Syntaksi: 

PEA <ea> <ea> -> stack 
missä <ea> on 
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Dn * d16(An) * d16(pc) 
An * d8(An Xn) * d8(pc,Xn) 
* (An) —* xxx, W 


(An)+ * xxx.L 
-(An) — f<data> 


Tilakoodit: 
N ei muutu 
Z ei muutu 
V ei muutu 
(0) ei muutu 
X ei muutu 
Esimerkki: 


Ohjelmassa on taulukko nimeltä TAUL, jonka alkuosoite halutaan pinomuistin pääl- 
limmäiseksi luvuksi: 
Käsky PEATAUL(pc) 
tallentaa taulukon alkuosoitteen pinoon 
Koska käsky käyttää suhteellista osoitusmuotoa, ei toiminta riipu ohjelman sijoittumi- 
sesta muistiin. 


RESET Reset External Devices 


RESET asettaa prosessorin /RESET-nastan loogiseen nollatilaan 128 kellojakson ajak- 
si nollaten kaikki oheispiirit. Käsky ei vaikuta prosessorin sisäiseen tilaan, vaan ohjelman 
suoritus jatkuu normaalisti seuraavasta käskystä RESET-pulssin päätyttyä. Käsky voi- 
daan suorittaa vain Supervisor-tilassa, muutoin tuloksena on guru 8. 

Syntaksi: 


RESET 
Tilakoodit: 

N ei muutu 

Z ei muutu 

V ei muutu 

0) ei muutu 

X ei muutu 


ROL/ROR — Rotate Left/Right 


Kierrättää kohteen arvoa halutun bittimäärän vasemmalle tai oikealle. Määrä voi olla 
välitön luku tai datarekisterin arvo. Mikäli kohde on muisti, siirto on mahdollinen vain 
yhden bitin kerrallaan. Tällöin kohdeoperandin koko voi olla vain 16 bittiä. 

ROL siirtää operandin bittejä vasemmalle. Alimpaan bittiin siirretään entinen ylin eli 
operandista pois siirtyvä bitti, joka sijoitetaan myös C-lippuun. 

ROR siirtää operandin bittejä oikealle. Ylimpään bittiin siirretään entinen alin bitti, jo- 
ka sijoitetaan myös C- lippuun. 
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Syntaksi: 
ROL.s DnDm 
ROL.s —f<data>,Dn 
ROL <ea> 


ROR.s Dn,Dm 
ROR.s —f<data>,Dn 


ROR <ea> 
missä <ea> on 
Dn *dl6(An) d16(pc) 
An — * d8(An,Xn) 8(pc,Xn) 


* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) — H<data> 
ja .son .B, W tai L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
E asettuu, jos tulos on nolla 
V nollautuu 
C asettuu viimeisen operandista siirretyn bitin mukaisesti 
X ei muutu 
Esimerkki: 


Alussa D0=$12345678 
Käsky RORL4%8,D0 
Lopussa D0=$78123456, C=0, N=0,Z=0 


ROXL/ROXR Rotate Left/Right With Extend 


Kierrättää kohteen arvoa halutun bittimäärän vasemmalle tai oikealle X-lipun kautta. 
Määrä voi olla välitön luku tai datarekisterin arvo. Mikäli kohde on muisti, siirto on mah- 
dollinen vain yhden bitin kerrallaan. Tällöin kohdeoperandin koko voi olla vain 16 bittiä. 
ROXL siirtää operandin bittejä vasemmalle. Alimpaan bittiin siirretään entinen X-lipun 
arvo ja operandista pois siirtyvä bitti sijoitetaan C- ja X-lippuihin. ROXR siirtää operan- 
din bittejä oikealle. Ylimpään bittiin siirretään entinen X-lipun tila ja alimmasta poistuva 
bitti menee C- ja X-lippuihin. 

Syntaksi: 

ROXL.s Dn,Dm 
ROXL.s f<data>,Dn 
ROXL —<ea> 
ROXR.s Dn,Dm 
ROXR.s f<data>,Dn 


ROXR —<ea> 
missä <ea> on 
Dn *dl6(An) d16(pc) 
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An — *d8(An,Xn) d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) — F<data> 
ja .son .B, .W tai L 


Tilakoodit: 
N asettuu, jos tuloksen ylin bitti on ykkönen 
Z asettuu, jos tulos on nolla 
V nollautuu 
C asettuu viimeisen operandista siirretyn bitin mukaisesti 
X asettuu viimeisen operandista siirretyn bitin mukaisesti 


C- ja X-liput asettuvat alkuperäiseen X-lipun tilaan, jos siirtokertojen lukumäärä oli 
nolla. 
Esimerkki: 
Alussa D0=$12345678, X=1 
Käsky —ROXR.L 44,D0 
Lopussa D0=$11234567, X=1, C=1, N=0,Z=0 


RTE Return From Exception 


RTE palauttaa prosessorin siihen tilaan, jossa se oli ennen exception-rutiiniin (esim. 
keskeytysrutiini) siirtymistä. Yksinkertaisimmillaan tämä tarkoittaa statusrekisterin ja oh- 
jelmalaskurin lataamista pinomuistista. Prosessorin kulloisestakin tilasta ja pinomuistin si- 
sällöstä riippuu, kuinka paljon tietoa pinosta otetaan. 

RTE-käskyn voi suorittaa vain Supervisor-tilassa, muulloin se aiheuttaa gurun 8. 


Syntaksi: 
RTE 
Tilakoodit: 
N pinosta 
Z pinosta 
V pinosta 
C pinosta 
X pinosta 


RTR Return and Restore Condition Codes 


RTR ottaa pinomuistista ensin 16-bittisen luvun, jonka alimmat bitit siirretään tilare- 
kisteriin ja sitten 32- bittisen luvun, joka siirretään ohjelmalaskuriin. 

RTR-käsky eroaa tavallisesta aliohjelmasta palaamiskäskystä, koska myös tilarekiste- 
rin arvo otetaan pinomuistista. 

RTR-käskyä käytettäessä on ennen aliohjelmakutsua muistettava tallentaa pinoon tila- 
rekisterin arvo 16- bittisenä. 

Syntaksi: 

RTR 
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Tilakoodit: 
N pinosta 
Z pinosta 
V pinosta 
(0 pinosta 
X pinosta 
RTS Return From Subroutine 


RTS ottaa pinomuistista 32-bittisen ohjelmalaskurin arvon. Sitä käytetään palattaessa 
aliohjelmista, joita on kutsuttu BSR- tai JSR-käskyllä. 


Syntaksi: 
RTS 

Tilakoodit: 
N ei muutu 
Z ei muutu 
V ei muutu 
(0) ei muutu 
X ei muutu 


SBCD Subtract Binary Coded Decimal With Extend 


Vähentää kohdeoperandin arvosta X-lipun ja lähdeoperandin käyttäen BCD-aritmetiik- 
kaa. Operaatio on aina 8-bittinen eli käsittää kaksi BCD-numeroa. 


Syntaksi: 
SBCD DnDm 
SBCD —-(An),-(Am) 


Tilakoodit: 
N ei määritelty 
Z ei määritelty, jos tulos on nolla; muuten nollautuu 
V ei määritelty 
C asettuu, jos piti lainata 
X asettuu, jos piti lainata 
Esimerkki: 


Alussa D0=$12, D1=$34, X=1 
Käsky SBCDD0,DI 
Lopussa D0=$12, D1=$21, X=0, C=0,Z=0 


Scc Set According to Condition 


Scc testaa käskyyn liittyvän ehdon toteutumisen. Jos ehto on tosi, kohteen kaikki kah- 
deksan bittiä asetetaan ykkösiksi, jos taas epätosi, kohteen bitit nollataan. 
Ehdon toteutuminen riippuu Bcc-käskyn tavoin tilarekisterin lippujen arvoista. Alla 
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oleva taulukko sisältää Scc-käskyn ehdosta riippuvat versiot. 


käsky — ehto testi 

SHI > /C JA /Z etumerkittömille luvuille 
SLS << CTAIZ etumerkittömille luvuille 
SCC >= C=0 etumerkittömille luvuille 
SCS < C=1 etumerkittömille luvuille 
SNE <> Z=0 kaikille luvuille 

SEO == Z=1 kaikille luvuille 

SVC V=0 

SVS V=1 

SPL >=0) N=0 

SMI <0 N=1 

SGE >= etumerkillisille luvuille 
SLT < etumerkillisille luvuille 
SGT > etumerkillisille luvuille 
SLE <= etumerkillisille luvuille 
SF aina epätosi 

ST aina tosi 


Jotkut assemblerit hyväksyvät edellisten lisäksi muodot SLO ja SHS, jotka käännettä- 
essä muuntuvat käskyiksi SCS ja SCC. Ihmisen kannalta on helpompi muistaa kuvaannol- 
lisemmat muodot SLO (Set if LOwer) ja SHS (Set if Higher or Same). 

Tilakoodit: 


N ei muutu 

Z ei muutu 

V ei muutu 

(& ei muutu 

X ei muutu 

Esimerkki: 
Alussa N=1 
Käsky SMIDO asettaa D0:n alimman tavun Sff:ksi 


Lopussa D0=$ff, N=1 


STOP Load Status Register and Stop 


Käskyä suoritettaessa siirretään välitön luku statusrekisteriin ja pysäytetään prosesso- 
rin käskyjen suoritus. 

Prosessori käynnistyy uudestaan vastaanotettuaan tärkeydeltään riittävän korkeatasoi- 
sen keskeytyksen tai ulkoisen /RESET-signaalin. 

Jos T-lippu (Trace) oli asetettuna, STOP ei aiheuta ohjelman pysähtymistä, vaan sen 
sijaan aloitetaan normaali Trace-rutiinin suoritus. 

Tämän käskyn voi suorittaa vain Supervisor-tilassa, muulloin se aiheuttaa gurun 8. 

Syntaksi: 

STOP ff<data> 
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Tilakoodit: 


N välittömän luvun bitti 3 

Z välittömän luvun bitti 2 

V välittömän luvun bitti 1 

C välittömän luvun bitti 0 

X välittömän luvun bitti 4 
Esimerkki: 


Käsky STOP 4$300 
pysäyttää prosessorin, käynnistymiseen vaaditaan /RESET-pulssi tai vähintään tason 4 
keskeytys. 


SUB Subtract Binary 

Vähentää lähteen kohteesta käyttäen binääriaritmetiikkaa. Tulos sijoitetaan kohtee- 
seen. Operaatio on joko 8-, 16- tai 32-bittinen. Jos vähennyslaskussa piti lainata (ts. lähde 
oli suurempi kuin kohde), X ja C asettuvat ykkösiksi. 


Syntaksi: 
SUB.s —<eal>,Dn <Dn> - (<ea1>) -> <Dn> 
SUB.s Dn,<ea2> (<ea2>) - <Dn> -> (<ea2>) 
missä <eal> on 
* Dn * d16(An) * d16(pc) 
* An * d8(An, Xn) * d8(pc,Xn) 


* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) * f<data> 


ja <ea2> on 
Dn *dl6(An) d16(pc) 
An —* d8(An,Xn) d8(pc,Xn) 


* (An) * xxx. W 

* (An)+ *xxx.L 

* (An) = H<data> 
ja.son .B, W tai .L 


Tilakoodit: 
N asettuu, jos tulos negatiivinen 
Z asettuu, jos tulos on nolla 
V asettuu, jos tapahtui ylivuoto 
c asettuu, jos piti lainata 
X asettuu, jos piti lainata 
Esimerkki: 


Alussa D0=$12345678, D1=$00880701 
Käsky SUB.LDI,D0O 
Lopussa DO=$1 1ac4f77, D1=$00880701, X=0, Z=0, N=0 
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SUBA Subtract Address 


Vähentää osoiterekisterin arvosta lähteen käyttäen binääriaritmetiikkaa. Operaatio on 
joko 16- tai 32- bittinen. Käsky ei vaikuta tilarekisterin lippuihin. 


Syntaksi: 

SUBA:s <ea>,An * <An>-(<ea>) -> <An> 
missä <ea> on 

* Dn * d16(An) * d16(pc) 


* An * d8(An Xn) * d8(pc,Xn) 
* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) *f<data> 
ja son W tai L 


Tilakoodit: 
N ei muutu 
Z ei muutu 
Vv ei muutu 
Cc ei muutu 
x ei muutu 
Esimerkki: 


Alussa A0=$00c13428 
Käsky —SUBA.L $00010000,40 
Lopussa A0=$00c03428 


SUBI  Subtract Immediate 


Vähentää kohteen arvosta välittömän luvun käyttäen binääriaritmetiikkaa. Operaatio 
on 8-, 16- tai 32- bittinen. Käskysanaa seuraa yksi tai kaksi tietosanaa riippuen operaati- 
on koosta (.L-operaatio vaatii kaksi sanaa eli neljä tavua välitöntä tietoa). Tilarekisterin li- 
put asettuvat normaalisti. 

Syntaksi: 

SUBI.s ff<data>,<ea> (<ea>) - <data> -> (<ea>) 
missä <ea> on 
* Dn * d16(An) d16(pc) 
An * d8(An, Xn) d8(pc,Xn) 
* (An) * xxx.W 
* (An)+ * xxx.L 
* (An) H<data> 
ja .son .B, .W tai L 


Tilakoodit: 
N asettuu, jos tulos negatiivinen 
Z asettuu, jos tulos on nolla 
V asettuu, jos tapahtui ylivuoto 
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C asettuu, jos piti lainata 
X asettuu, jos piti lainata 
Esimerkki: 
Alussa D0=$12e82341 
Käsky SUBI.W 4$f234,D0 
Lopussa D0=$12e8310d, X=1, C=1, V=0,Z=0, N=0 


SUBO Subtract Ouick 


Vähentää käskykoodiin sisältyvän luvun kohteesta käyttäen binääriaritmetiikkaa. Ope- 
raatio on 8-, 16- tai 32- bittinen paitsi kun kohteena on osoiterekisteri, jolloin 8-bittistä 
muotoa ei voi käyttää. Vähennettävä luku voi olla 1...8. Koska se sisältyy käskykoodiin, 
käskyyn ei liity muuta välitöntä tietoa ja käskyn suoritusaika on lyhyempi kuin vastaan- 
van ADDI'n. Käsky soveltuu hyvin esimerkiksi silmukkalaskurien pienentämiseen ja kor- 
vaa useissa muissa prosessoreissa olevan DEC-käskyn. Käsky vaikuttaa normaalisti tilare- 
kisterin lippuihin. 

Syntaksi: 

SUBO.s ff<data>,<ea> (<ea>) - <data> -> (<ea>) 
missä <ea> on 

* Dn * d16(An) d16(pc) 

* An * d8(An,Xn) d8(pc,Xn) 

* (An) * xxx. W 

* (An)+ * xxx.L 

* (An) — H<data> 

ja .son B,.W tai L 


Tilakoodit: 
N asettuu, jos tulos negatiivinen 
Z asettuu, jos tulos on nolla 
V asettuu, jos tapahtui ylivuoto 
(0 asettuu, jos piti lainata 
X asettuu, jos piti lainata 
Esimerkki: 


Alussa D0=$12e82384 
Käsky SUBO.B 4$3,D0 
Lopussa D0=$12e82381, X=0, C=0, V=0,Z=0, N=1 


SUBX Subtract Binary With Extend 


Vähentää lähdeoperandin arvon ja X-lipun kohteesta käyttäen binääriaritmetiikkaa. 
Koska käsky ottaa huomioon myös extend-bitin (X-lipun) arvon, voidaan tätä käskyä 
käyttäen vähentää toisistaan yli 32-bittisiä lukuja. Tällöin edellisten lukujen vähennyslas- 
kussa mahdollisesti syntynyt "lainausnumero" vähennetään seuraavaksi enemmän merkit- 
sevien lukujen vähennyslaskussa. SUBX-käskystä on vain kaksi osoitusmuotoa. Käsky 
asettaa tilarekisterin liput tulosta vastaaviksi. 
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Syntaksi: 
SUBX.s Dsrc,Ddst <Ddst>-<Dsrc>-X -> <Ddst> 
SUBX.s -(Asrc),-(Adst) 
missä .s on .B, W tai .L 


Tilakoodit: 
N ei määritelty 
Z asettuu, jos tulos on nolla 
V ei määritelty 
c asettuu, jos piti lainata 
X asettuu, jos piti lainata 
Esimerkki: 


Alussa  D0=$00000007, D1=$00000004, X=1 
Käsky SUBXBDI,D0 
Lopussa D0=$00000002, D1=$00000004, X=0., C=0, Z=0 


SWAP — Swap Register Halves 


Vaihtaa datarekisterin ylä- ja alapuoliskojen sisällöt keskenään. Siis bitit 0...15 siirty- 
vät rekisterin bitteihin 16...31 ja päinvastoin. 


Syntaksi: 
SWAP Dn 
Tilakoodit: 
N asettuu, jos tuloksen bitti 31 oli ykkönen 
Z asettuu, jos tulos on nolla 
V nollautuu 
(O nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$12345678 
Käsky SWAPDO0 
Lopussa D0=$56781234, N=0,Z=0 


TAS Indivisible Test and Set 


TAS testaa operandina olevan tavun tilan ja asettaa N- ja Z-liput vastaavasti. Lopuksi 
se asettaa operandin bitin 7 ykköseksi. 

TAS käyttää ns. read-modify-write-muistijaksoa, jolloin mikään muu järjestelmään 
kuuluva prosessori ei voi keskeyttää käskyn suoritusta testaamisen ja bitin asettamisen vä- 
lisenä aikana. Tätä ominaisuutta voidaan käyttää hyväksi moniprosessorijärjestelmissä. 

Syntaksi: 


TAS <ea> 
missä <ea> on 
* Dn * d16(An) d16(pc) 
An * d8(An Xn) d8(pc,Xn) 
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* (An) * xxx. W 
* (An)+ * xxx.L 
* (An) f<data> 


Tilakoodit: 
N asettuu, jos operandin bitti 7 oli ykkönen 
Z asettuu, jos operandin arvo oli nolla 
V nollautuu 
C nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$01 
Käsky TASDO 
Lopussa D0=$81, N=0,Z=0 


TRAP Trap Through Exception Table 


TRAP tallentaa ohjelmalaskurin (joka osoittaa TRAP-käskyä seuraavaan käskyyn) ja 
status-rekisterin pinoon ja hyppää välittömän luvun määräämän TRAP-vektorin kautta. 
Käskyn suorituksen jälkeen prosessori toimii Supervisor- tilassa. Ellei käyttäjä aseta ao. 
TRAP-vektoria ennen käskyn käyttöä, se aiheuttaa gurun. 

Syntaksi: 

TRAP — f<vector> 
missä <vector> on TRAP-vektorin numero 0...15. 


Tilakoodit: 
N ei muutu 
Z ei muutu 
V ei muutu 
C ei muutu 
X ei muutu 
Esimerkki: 


Käsky TRAP%3 
hyppää TRAP-vektorin 3 kautta (osoitteessa $8c) 


TRAPV Trap on Overflow 


TRAPV hyppää exception-vektorin 7 kautta (osoitteessa $1c), jos V- eli ylivuotolippu 
oli ykkönen. Jos V=0, suoritus jatkuu normaalisti seuraavasta käskystä. 

Syntaksi: 

TRAPV 

Tilakoodit: 
ei muutu 
ei muutu 
ei muutu 
ei muutu 


O <NzZ 


163 


MC68000:n käskykanta 


X ei muutu 
Esimerkki: 
Käsky TRAPV 
hyppää exception-vektorin 7 kautta jos V=1 


TST Test an Operand 


TST testaa operandin tilan ja asettaa N- ja Z-liput vastaavasti. Mikäli operandin ylin 
bitti oli ykkönen, N asettuu ja jos operandin arvo oli nolla, Z asettuu. TST ei muuta ope- 
randin arvoa. 


Syntaksi: 
TST.s —<ea> 
missä <ea> on 
* Dn * d16(An) d16(pc) 
An * d8(An Xn) d8(pc,Xn) 


* (An) —* xxx. W 

* (An)+ *xxx.L 

* -(An) H<data> 
ja.son B, W tai L 
Tilakoodit: 


N asettuu, jos operandin ylin bitti oli ykkönen 
Z asettuu, jos operandin arvo oli nolla 
V nollautuu 
(0 nollautuu 
X ei muutu 
Esimerkki: 


Alussa D0=$01 
Käsky TST.BD0 
Lopussa D0=$01, N=0,Z=0 


UNLK Unlink and Deallocate Stack 


UNLK siirtää annetun osoiterekisterin arvon pino-osoittimeen vapauttaen siten LINK- 
käskyllä varatun osan pinomuistista. Sitten pinosta otetaan 32-bittinen luku em. osoitere- 
kisteriin (sama luku tallennettiin pinoon LINK- käskyn suorituksen aikana). Käytetyn 
osoiterekisterin arvo ei saa muuttua LINK- ja UNLK-käskyjen välisenä aikana. 

Syntaksi: 


UNLK An 
Tilakoodit: 

N ei muutu 

Z ei muutu 

V ei muutu 

(0) ei muutu 

X ei muutu 
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Liite B 
Käyttöjärjestelmärutiinien 
kutsuminen 


Amigan käyttöjärjestelmän rutiinien kutsuoffsetit ja parametrit. 


n kutsuttaessa offset lisätään kirjaston perusosoitteeseen, joka saatiin Open- 
Library-kutsulla. Käyttöjärjestelmä olettaa, että tämä tehdään lataamalla kirjaston 
perusosoite a6-rekisteriin ja käyttämällä epäsuoraa osoitusta 16 bitin offsetilla. Esimerkik- 
si Open-rutiinin kutsuminen tapahtuu seuraavasti: 


move. DosBase,a6 ; ladataan dos-kirjaston perusosoite 

jsr -S001e(a6) ; kutsutaan Open-rutiinia 
Makroassemblerilla sama tapahtuu seuraavasti: 

move.] DosBase,a6 ; ladataan dos-kirjaston perusosoite 

JSr  LVOOpen(a6) =; kutsutaan Open-rutiinia 


Makroassembleria käytettäessä on käytettävät rutiinit määriteltävä ohjelman alussa 

XREF-komennolla ohjelman ulkoisiksi viittauksiksi, esim. 
XRFF  LVOOpen 
XREF = LVOClose jne. 

Tällöin linkkeri hoitaa symbolien määrittelemisen amiga.lib- tiedoston mukaisesti. 

Ilman makroassembleria toimittaessa on symbolien määrittely tehtävä käsin EOU-ko- 
mentoa käyttäen. Vaihtoehtoisesti voidaan käyttää suoraan kutsuoffsetin numeerista ar- 
voa, mikä ei ole suositeltavaa sen epähavainnollisuuden vuoksi. 

Seuraavassa taulukossa on lueteltu kaikki Amigan käyttöjärjestelmän version 1.2 ru- 
tiinit. Vasemmassa reunassa ovat kutsuoffset, rutiinin nimi, suluissa parametrit ja lopuksi 
vastaavassa järjestyksessä rekisterit, joissa parametrit annetaan. Taulukon avulla voidaan 
käyttää myös sellaisia rutiineja, joita ei ole esitelty erikseen tässä kirjassa. 


Offsets: clist.lib 
- 001E InitCl(cLPool,size)(A0,D0) 
- 0024 AllocCList(cLPool)X(A1) 
- 002A FreeCList(cList)(A0) 
- 0030 FlushCList(cList)(A0) 
- 0036 SizeCList(cList)(A0) 
- 003C PutCLChar(cList,byte)(A0,D0) 
- 0042 GetCLChar(cList)(A0) 
- 0048 UnGetCLChar(cList,byte)(A0,D0) 
- 004E UnPutCLChar(cList)(A0) 
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- 0054 PutCLWord(cList,word)(A0,D0) 

- 005A GetCLWord(cList)(A0) 

- 0060 UnGetCLWord(cList,word)(A0,D0) 

- 0066 UnPutCLWord(cList)(A0) 

- 006C PutCL Buf(cList,buffer,length)(A0,A1,D1) 

- 0072 GetCLBuf(cList,buffer,maxLength)(A0,A1,D1) 
- 0078 MarkCList(cList,offset)(A0,D0) 

- 007E IncrCLMark(cList)(A0) 

- 0084 PeekCLMark(cList)(A0) 

- 008A SplitCList(cList)(A0) 

- 0090 CopyCList(cList)(A0) 

- 0096 SubCList(cList,index,length)(A0,D0/D 1) 

- 009C ConcatCList(sourceCList,destCList)(A0,A 1) 


Offsets: console.lib 


- 002A CDInputHandler(events,device)(A0/A1) 

- 0030 RawKeyConvert(events,buffer,length,keyMap)(A0/A1,D1/A2) 
- 0036 AskDefaultKeyMap(keyMap)(A0) 

- 003C SetDefaultKey Map(keyMap)(A0) 


Offsets: cstrings.lib 


- 001E aTailPath() 

- 0024 TailPath(path)(A0) 

- 002A abcopy() 

- 0030 bcopy(src,dest,len)(a0/a1 d0) 
- 0036 abzero() 

- 003C bzero(buf,len)(a0/d0) 

- 0042 aindex() 

- 0048 index(string,value)(a0,d0) 

- 004E arindex() 

- 0054 rindex(string,value)(a0,d0) 

- O05A ascopy() 

- 0060 scopy(string)(a0) 

- 0066 asfree() 

- 006C sfree(string)(a0) 

- 0072 astreat() 

- 0078 strcat(to,from)(a0/a0) 

- 007E astremp() 

- 0084 strempffirststring,secondstring)(a0/a1) 
- 008A astrepy() 

- 0090 strepy(firststring ,secondstring)(a0/a1) 
- 0096 astrlen() 
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- 009C strlen(string)(a0) 

- 00A2 astrncat() 

- 00A8 strncat(to,from,count)(a0/a1,d0) 

- 00AE astrncmp() 

- 00B4 strncmpf(firststring ,secondstring,count)(a0/a1,d0) 
- 00BA astrncpy() 

- 00C0 strncpy(to,from,count)(a0/a1 ,d0) 

- 00C6 asuffix() 

- 00CC suffix(string,suffix)(a0/a1) 


Offsets: diskfont.lib 


- 001E OpenDiskFont(textAttr)(A0) 

- 0024 AvailFonts(buffer,bufBytes,flags)(A0,D0/D 1) 

- 002A NewFontContents(fontsLock ,fontName)(A0/A1) 

- 0030 DisposeFontContents(fontContentsHeader)(A 1) 
Offsets: dos.lib 

- 001E Open(name,accessMode)(D1/D2) 

- 0024 Close(file)(D1) 

- 002A Read(file buffer,length)(D1/D2/D3) 

- 0030 Write(file,buffer,length)(D1/D2/D3) 

- 0036 Input() 

- 003C Output() 

- 0042 Seek(file,position,offset)(D1/D2/D3) 

- 0048 DeleteFile(name)(D1) 

- 004E Rename(oldName,newName)(D1/D2) 

- 0054 Lock(name,type)/(D1/D2) 

- 005A UnLock(lock/(D1) 

- 0060 DupLock(lock)(D1) 

- 0066 Examine(lock,fileInfoBlock )(D1/D2) 

- 006C ExNext(lock,fileInfoBlock)/(D1/D2) 

- 0072 Info(lock ,parameterBlock (D1/D2) 

- 0078 CreateDir(name)(D1) 

- 007E CurrentDir(1ock(D1) 

- 0084 IoErr() 

- 008A CreateProc(name,pri,segList,stackSize)D1/D2/D3/D4) 

- 0090 Exit(returnCode)(D1) 

- 0096 LoadSeg(fileName)(D1) 

- 009C UnLoadSeg(segment)(D1) 

- 00A2 GetPacket(wait)(D1) 

- 00A8 OueuePacket(packet (D1) 

- 00AE DeviceProc(name)(D1) 
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- 00B4 SetComment(name,comment)(D1/D2) 
- OOBA SetProtection(name,mask )(D1/D2) 

- 00CO DateStamp(date)/(D1) 

- 00C6 Delay(timeout)X(D1) 

- 00CC WaitForChar(file,timeout)(D1/D2) 

- 00D2 ParentDir(1ockD1) 

- 00D8 IsInteractive(file)D1) 

- OODE Execute(string,file,filexD1/D2/D3) 


Offsets: exec.lib 


Special functions 

- 001E Supervisor() 

- 0024 ExitlIntr() 

- 002A Schedule() 

- 0030 Reschedule() 

- 0036 Switch() 

- 003C Dispatch() 

- 0042 Exception() 

- 0048 InitCode(startClass,version)(D0/D1) 

- 004E InitStruct(initTable,memory ,size)(A1/A2,D0) 

- 0054 MakeLibrary(funclInit structInit libInit,dataSize,codeSize) 
(A0/A 1/A2,D0/D1) 

- O05A MakeFunctions(target,functionArray funcDispBase)(A0,A1,A2) 

- 0060 FindResident(name)(A1) 

- 0066 InitResident(resident,segList)(A1,D1) 

- 006C Alert(alertNum,parameters)(D7,A5) 

- 0072 Debug() 

Interrupts 

- 0078 Disable() 

- 007E Enable() 

- 0084 Forbid() 

- O008A Permit() 

- 0090 SetSR(newSR,mask)(D0/D1) 

- 0096 SupersState() 

- 009C UserState(sysStack)(D0) 

- 0042 SetIntVector(intNumber,interrupt)(DO/A 1) 

- 00A8 AddlntServer(intNumber,interrupt)(DO/A 1) 

- 00AE RemlntServer(intNumber,interrupt)(DO/A 1) 

- 00B4 Cause(interrupt)(A 1) 

Memory allocation 

- 0O0BA Allocate(freeList,byteSize)(A0,D0) 

- 00C0 Deallocate(freeList.memoryBlock byteSize)(A0/A 1,D0) 
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- 00C6 AllocMem(byteSize,reguirements)(D0/D1) 
- 00CC AllocAbs(byteSize location)(DO/A1) 

- 00D? FreeMem(memoryBlock byteSize)(A1,D0) 
- 00D8 AvailMem(reguirements)(D1) 

- 00DE AllocEntry(entry)(A0) 

- 00E4 FreeEntry(entry)(A0) 

Lists 

- O00EA Insert(list,node,pred)(A0/A1/A2) 

- 00F0 AddHead(list,node)/(A0/A 1) 

- 00F6 AddTail(list. node)(A0/A1) 

- 00FC Remove(node)(A1) 

- 0102 RemHead(list)(A0) 

- 0108 RemTail(list)(A0) 

-010E Engueue(list,node)(A0/A 1) 

- 0114 FindName(list,name)(A0/A 1) 

Tasks 

- OLA AddTask(task initPC finalPC)(A1/A2/A3) 
- 0120 RemTask(task (A 1) 

- 0126 FindTask(name)(A 1) 

- 012C SetTaskPri(task,priority)(A1,D0) 

- 0132 SetSignal(newSignals,signalSet)(D0/D 1) 
- 0138 SetExcept(newSignals,signalSet)(D0/D1) 
-013E Wait(signalSet)(D0) 

- 0144 Signal(task,signalSet)(A 1,DO) 

- 014A AllocSignal(signalNum)(D0) 

- 0150 FreeSignal(signalNum)(D0) 

- 0156 AllocTrap(trapNum)(D0) 

-015C FreeTrap(trapNum)(DO) 

Messages 

- 0162 AddPort(port)(A 1) 

- 0168 RemPort(port)(A1) 

-016E PutMsg(port,message)( AO/A 1) 

- 0174 GetMsg(port)(A0) 

- 0I7A ReplyMsg(message)(A1) 

- 0180 WaitPort(port)(A0) 

- 0186 FindPort(name)(A 1) 

Libraries 

- 018C AddLibrary(library (A 1) 

- 0192 RemLibrary(library)(A1) 

- 0198 OldOpenLibrary(libName)(A 1) 

- 019E CloseLibrary(library)(A1) 

- 01A4 SetFunction(library funcOffset,funcEntry)(A1,40,D0) 
-01AA SumLibrary(library)(A1) 
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Devices 

- 01BO AddDevice(device)(A |) 

- 01B6 RemDevice(device)(A1) 

- 01BC OpenDevice(devName,unit,ioReguest,flags)(A0,D0/A 1,D1) 
-01C2 CloseDevice(ioReguest)(A 1) 

-01C8 DolO(ioReguest)(A 1) 

-0ICE SendIO(ioReguest)(A 1) 

-01D4 CheckIO(ioReguest)(A 1) 

-0OIDA WaitlO(ioReguest)(A 1) 

- 01EO AbortIO(ioReguest)(A1) 

Resources 

- 01E6 AddResource(resource)(A 1) 

-01EC RemResource(resource)(A 1) 

-01F2 OpenResource(resName,version)(A 1,D0) 
New functions 

- 01F8 RawlOlnit() 

-01FE RawMayGetChar() 

- 0204 RawPutChar(char)(dO) 

- 020A RawDoFmt()(AO/A 1/A2/A 3) 

- 0210 GetCC() 

- 0216 TypeOfMem(address)(A1); 

- 021C Procure(semaport,bidMsg)(A0/A 1) 

- 0222 Vacate(semaport)(A0) 

- 0228 OpenLibrary(libName, version )(A 1,D0) 
1.2 new semaphore support 

- 022E InitSemaphore(sigSem)(A0) 

- 0234 ObtainSemaphore(sigSem)(A0) 

- 023A ReleaseSemaphore(sigSem)(A0) 

- 0240 AttemptSemaphore(sigSem)(A0) 

- 0246 ObtainSemaphoreList(sigSem)(A0) 

- 024C ReleaseSemaphoreList(sigSem)(A0) 

- 0252 FindSemaphore(sigSem)(A0) 

- 0258 AddSemaphore(sigSem)(A0) 

- 025E RemSemaphore(sigSem)(A0) 

1.2 rom "kickstart" support + memory support 

- 0264 SumKickData() 

- 026A AddMemList(size,attributes,pri,base,name)(D0/D1/D2/A0/A 1) 
- 0270 CopyMem(source,dest,size)(A0/A 1,D0) 
- 0276 CopyMemOuick(source,dest,size)( A0/A 1,D0) 


Offsets: expansion.lib 
- 001E AddConfigDev(configDev )(A0) 
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- 0024 
- 002A 
- 0030 
- 0036 
- 003C 
- 0042 
- 0048 
- 004E 
- 0054 
- 005A 
- 0060 
- 0066 
- 006C 
- 0072 
- 0078 
- 007E 
- 0084 
- 008A 
- 0090 
- 0096 


expansionUnused() 

AllocBoardMem(slotSpec)(D0) 

AllocConfigDev() 
AllocExpansionMem(numSlots,SlotAlign,SlotOffset)(D0/D1/D2) 
ConfigBoard(board,configDev)(AO0/A1) 
ConfigChain(baseAddr)(A0) 
FindContigDev(oldConfigDev,manufacturer,product)(A0,D0/D 1) 
FreeBoardMem(startSlot,slotSpec)(D0/D 1) 
FreeConfigDev(configDev )(A0) 
FreeExpansionMem(startSlot,numSlots)(D0/D 1) 
ReadExpansionByte(board, offset) (A0,D0) 
ReadExpansionRom(board,configDev)(A0/A1) 
RemConfigDev(configDev )/(A0) 
WriteExpansionByte(board,offset,byte)(A0,D0/D1) 
ObtainConfigBinding() 

ReleaseConfigBinding() 

SetCurrentBinding(currentBinding bindingSize)(A0,D0) 
GetCurrentBinding(currentBinding bindingSize)(A0,D0) 
MakeDosNode(parmPacket)(A0) 
AddDosNode(bootPri,flags,dosNode)(D0/D1/A0) 


Offsets: graphics.lib 


Text routines 


- 001E 


- 0024 


- 002A 
- 0030 
- 0036 
- 003C 
- 0042 
- 0048 
- 004E 
- 0054 
- 005A 


Gels routines 


- 0060 
- 0066 
- 006C 
- 0072 
- 0078 


BItBitMap(srcBitMap,srceX,srcY ,destBitMap,destX,destY ,sizeX,sizeY, 
minterm,mask,tempA)(A0,D0/D1,A1,D2/D3/D4/D5/D6/D7/A2) 
BltTemplate(source,srcX srcMod,destRastPort,destX ,destY ,sizeX sizeY ) 
(A0,D0/D1/A 1,D2/D3/D4/D5) 

ClearEOL(rastPort)(A 1) 

ClearScreen(rastPort)(A 1) 
TextLength(RastPort,string,count)(A1,40,D0) 
Text(RastPort,string,count)(A 1,40,D0) 

SetFont(RastPortID textFont)(A 1,40) 

OpenFont(textAttr)(A0) 

CloseFont(textFont)(A1) 

AskSoftStyle(rastPort)(A1) 

SetSoftStyle(rastPort,style,enable)(A 1,D0/D1) 


AddBob(bob,rastPort)(A0,A 1) 

AddV Sprite(vSprite,rastPort)(A0/A1) 
DoCollision(rasPort)(A 1) 
DrawGList(rastPort,viewPort)(A1,A0) 
InitGels(dummyHead,dummyTail,GelsInfo)(A0/A 1/42) 
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- 007E 
- 0084 

- 008A 
- 0090 

- 0096 

- 009C 
- 0042 
- 00A8 
- O00AE 
- 00B4 
- 00BA 


InitMasks(vSprite)(A0O) 
RemIBob(bob,rastPort,viewPort)(A0/A 1/A2) 

RemV Sprite(vSprite)(A0) 

SetCollision(type routine,gelsInfo)(DO/AO0/A1) 
SortGList(rastPort)XA1) 
AddAnimOb(obj,animationKey rastPort)(A0/A 1/42) 
Animate(animationKey,rastPort)(A0/A 1) 
GetGBuffers(animationObj rastPort,doubleBuffer)(A0/A1,D0) 
InitGMasks(animationObj )(A0) 
DrawEllipse(rastPort,cx,cy,a,b)(A1,D0/D1/D2/D3) 
AreaEllipse(rastPort,cx,cy,a,b)(A1,D0/D1/D2/D3) 


Remaining graphics routines 


- 00C0 
- 00C6 
- 00CC 
- 00D2 
- 00D8 
- 0O0DE 
- 00E4 
- O00EA 
- 00F0 
- 00F6 
- 00FC 
- 0102 
- 0108 
- 010E 
- 0114 
- OLA 
- 0120 
- 0126 
- 012C 
- 0132 
- 0138 


- 013E 
- 0144 
- 014A 
- 0150 
- 0156 
- 015C 
- 0162 
- 0168 
- 016E 


LoadRGB4(viewPort,colors,count)(A0/A 1,D0O) 
InitRastPort(rastPort)(A 1) 

Init VPort(viewPort)(A0) 

MrgCop(view)(A1) 

Make VPort(view,viewPort)(A0/A 1) 
LoadView(view)(A 1) 

WaitBlit() 

SetRast(rastPort,color)(A1,D0) 
Move(rastPort,x,y)(A 1,D0/D1) 
Draw(rastPort,x,y)(A1,D0/D1) 
AreaMove(rastPort,x,y)(A1,D0/D 1) 
AreaDraw(rastPort,x,y)(A1,D0/D 1) 
AreaEnd(rastPort)X(A1) 

WaitTOF() 

OBIit(blit(A1) 

InitArea(areaInfo,vectorTable vectorTableSize)( A0/A1,D0) 
SetRGB4(viewPort,index,r,g,b)(A0,D0/D1/D2/D3) 
OBSBIit(blit)(A1) 

BliClear(memory ,size,flags)(A1,D0/D1) 
RectFill(rastPort,xl,yl,xu,yu)(A 1,D0/D1/D2/D3) 
BltPattern(rastPort,ras,x1,yl,maxX,maxY.fillBytes) 
(a1,a0,D0/D1/D2/D3/D4) 
ReadPixel(rastPort,x,y)(A1,D0/D1) 
WritePixel(rastPort,x,y)(A1,D0/D 1) 
Flood(rastPort,mode,x,y)(A1,D2,D0/D 1) 
PolyDraw(rastPort,count,polyTable)(A 1,D0,A0) 
SetAPen(rastPort,pen)(A1,D0) 
SetBPen(rastPort,pen)(A 1,D0) 
SetDrMd(rastPort,draw Mode)(A1,D0) 
InitView(view)/(A1) 

CBump(copperList)(A1) 
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- 0174 
- OI7A 
- 0180 
- 0186 
- 018C 


- 0192 
- 0198 
- O19E 
-01A4 
-01AA 
-01B0 
- 01B6 
- 01BC 
- 01C2 
- 01C8 
- OICE 
- 01D4 
- 0IDA 
- 01EO 
- 01E6 
- 01EC 
- 01F2 
- 01F8 
- 01FE 
- 0204 
- 020A 
- 0210 
- 0216 
- 021C 
- 0222 
- 0228 


- 022E 
- 0234 
- 023A 
- 0240 
- 0246 
- 024C 
- 0252 
- 0258 
- 025E 
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CMove(copperList,destination,data)(A1,D0/D 1) 
CWait(copperList,x,y (A1,D0/D 1) 

VBeamPos() 
InitBitMap(bitMap,depth,width,height)(A0,D0/D 1/D2) 
ScrollRaster(rastPort,dX,dY,minx,miny,maxx,maxy) 
(A1,D0/D1/D2/D3/D4/D5) 
WaitBOVP(viewport)(a0) 
GetSprite(simplesprite,num)(a0,d0) 
FreeSprite(num)(dO) 
ChangeSprite(vp,simplesprite,data)(a0/a1/a2) 
MoveSprite(viewport,simplesprite,x,y)(a0/a1,d0/d1) 
LockLayerRom(layer)(a5) 
UnlockLayerRom(layer)(a5) 

SyncSBitMap(l)(a0) 

CopySBitMap(l1.12)(a0/a1) 

OwnBlitter()() 

DisownBlitter()() 
InitTmpRas(tmpras,buff,size)(a0/a1,d0) 
AskFont(rastPort,textAttr)(A1,40) 
AddFont(textFont)XA1) 

RemFont(textFont)(A 1) 
AllocRaster(width,height)(D0/D1) 
FreeRaster(planeptr,width,height)(A0,D0/D 1) 
AndRectRegion(rgn,rect)(A0/A 1) 
OrRectRegion(rgn,rect)(A0/A 1) 

NewRegion()() 

NotRegion(rgn)(A0) 

ClearRegion(rgn)(A0) 

DisposeRegion(rgn)(A0) 

Free VPortCopLists(viewport)(a0) 
FreeCopList(coplist)(a0) 

ClipBlit(srcrp,srcX,srcY ,destrp,destX,dest Y ,sizeX,sizeY ,minterm) 
(A0,D0/D1,A 1,D2/D3/D4/D5/D6) 
XorRectRegion(rgn,rect)(a0/a1) 
FreeCprList(cprlist)(a0) 

GetColorMapf(entries)(dO) 
FreeColorMap(colormap)(a0) 
GetRGB4(colormap,entry)(a0.d0) 

Scroll VPort(vp)(a0) 
UCopperListInit(copperlist,num)(a0,d0) 
FreeGBuffers(animationObj rastPort,doubleBuffer)(A0/A1,D0) 
BItBitMapRastPort(srcbm,srcx,srcy,destrp,destX,dest Y,sizeX,sizeY, 
minterm)(A0,D0/D1,A1,D2/D3/D4/D5/D6) 
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- 0264 
- 026A 
- 0270 
- 0276 
- 027C 


- 0282 
- 0288 
- 028E 


OrRegionRegion(src,dst)(a0/a1) 

XorRegionRegion(src,dst)(a0/a1) 

AndRegionRegion(src,dst)(a0/a1) 
SetRGB4CM(cm.i,r,g,b)(a0,d0/d1/d2/d3) 
BltMaskBitMapRastPort(srcbm,srcx,srcy,destrp,destX,destY ,sizeX, 
size Y ,minterm,bltmask)(A0,D0/D1,A 1,D2/D3/D4/D5/D6.,A2) 
GraphicsReservedl()() 

GraphicsReserved2()() 

AttemptLockLayerRom(layer)(a5) 


Offsets: icon.lib 


Normal functions 


- 001E 
- 0024 
- 002A 
- 0030 
- 0036 
- 003C 
- 0042 
- 0048 
- 004E 
- 0054 
- 005A 
- 0060 
- 0066 
- 006C 


Offsets: 


- 001E 
- 0024 
- 002A 
- 0030 
- 0036 
- 003C 
- 0042 
- 0048 
- 004E 
- 0054 
- 005A 
- 0060 
- 0066 
- 006C 


GetWBObject(name)(A0) 
PutWBObject(name,object)(A0/A 1) 
Getlcon(name,icon,freelist)(A0/A 1/A2) 
Putlcon(name,icon)(A0/A1) 
FreeFreeList(freelist)(A0) 
FreeWBObject(WBObject)(A0) 
AllocWBObject()() 

AddFreeList(freelist mem,size)(AO/A 1/A2) 
GetDiskObject(name)(A0) 
PutDiskObject(name,diskobj (A0,A1) 
FreeDiskObject(diskobj)(A0) 
FindToolType(toolTypeArray.typeName)(A0/A1) 
MatchToolValue(typeString,value)(A0/A 1) 
BumpRevision(newname,oldname)(A0/A 1) 


intuition.lib 


Openlntuition()() 

Intuition(ievent)(AO) 

AddGadget(AddPtr,Gadget,Position)(A0/A 1,D0) 
ClearDMReguest(Window )(A0) 

ClearMenuStrip(Window)(A0) 

ClearPointer(Window )(A0) 

CloseScreen(Screen)(A0) 

CloseWindow(Window )(A0) 

CloseWorkBench()() 

CurrentTime(Seconds Micros)(A0/A 1) 
DisplayAlert(AlertNumber String,Height)(D0/4A0,D!) 
DisplayBeep(Screen)(A0) 
DoubleClick(sseconds,smicros,eseconds,cmicros)(D0/D 1/D2/D3) 
DrawBorder(RPort Border ,LeftOffset, TopOffset)(A0/A 1,D0/D 1) 
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- 0072 
- 0078 
- 007E 
- 0084 
- 008A 
- 0090 
- 0096 
- 009C 


- 00A2 
- 0048 
- 00AE 
- 00B4 
- 00BA 
- 00C0 
- 00C6 
- 00CC 
- 00D2 
- 00D8 
- 00DE 
- 00E4 
- 00EA 
- 00F0 

- 00F6 

- 00FC 
- 0102 

- 0108 

- 010E 


- 0114 
- OLIA 
- 0120 
- 0126 
- 012C 
- 0132 
- 0138 
- 013E 
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DrawImage(RPort,Image,LeftOffset,TopOffset)( AO0/A 1,D0/D 1) 
EndReguest(reguester,window)(A0/A1) 
GetDefPrefs(preferences,size)(A0,D0) 
GetPrefs(preferences,size)( A0,D0) 

InitReguester(reg)(A0) 
ItemAddress(MenuStrip,MenuNumber)(A0,D0) 
ModifyIDCMP(Window Flags)(A0,D0) 
ModifyProp(Gadget,Ptr,Reg,Flags,HPos, VPos, HBody,VBo 
dy)(A0/A 1/A2,D0/D 1/D2/D3/D4) 
MoveScreen(Screen,dx,dy)(A0,D0/D 1) 
MoveWindow(window,dx,dy)(A0,D0/D1) 


* OffGadger(Gadget Ptr,Reg)(A0/A 1/A2) 


OffMenu(Window,MenuNumber)(A0,D0) 
OnGadget(Gadget,Ptr,Reg)(A0/A 1/A2) 
OnMenu(Window,MenuNumber)(A0,D0) 
OpenScreen(OSargs)(A0) 

Open Window(OWargs)(A0) 

OpenWorkBench()() 

PrintIText(rp,itext left, top)(A0/A1,D0/D 1) 
RefreshGadgets(Gadgets Ptr,Reg)(A0/A1/A2) 
RemoveGadget(RemPtr,Gadget)(A0/A 1) 
ReportMouse( Window, Boolean)(A0/D0) 
Reguest(Reguester, Window )(A0/A1) 
ScreenToBack(Screen)(A0) 

ScreenToFront(Screen)(A0) 
SetDMReguest(Window,reg)(A0/A 1) 
SetMenuStrip(Window,Menu)(A0/A |) 

SetPointer(Window Pointer,Height,Width,Xoffset,Yoffset) 
(A0/A1,D0/D1/D2/D3) 

Set WindowTitles(window,window'itle,screentitle)(A0/A1/A2) 
ShowTitle(Screen,ShowIt)(A0,D0) 
SizeWindow(window,dx,dy)(A0,D0/D 1) 

ViewAddress()() 

ViewPortAddress(window )(A0) 
WindowToBack(window)(A0) 
WindowToFront(window)(A0) 
WindowLimits(window,minwidth,minheight,maxwidth,maxheight) 
(A0,D0/D1/D2/D3) 


Start of next generation of names 


- 0144 


SetPrefs(preferences,size,flag)(A0,D0/D 1) 


Start of next next generation of names 


- 014A 
- 0150 


IntuiTextLength(itext)(A0) 
WBenchToBack(X() 
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- 0156 


WBenchToFront()() 


Start of next next next generation of names 


- 015C 


- 0162 
- 0168 


- 016E 
- 0174 
- 017A 
- 0180 
- 0186 


AutoReguest(Window Body.PText,NText,PFlag,NFlag,W,H) 
(A0,A1.A2,43,D0,D 1,D2.D3) 

BeginRefresh(Window)(A0) 
BuildSysReguest(Window Body PosText,NegText,Flags,W,H) 
(A0,A1,42,43,D0,D 1,D2) 

EndRefresh(Window ,Complete)(A0,D0) 
FreeSysReguest(Window )(A0) 

MakeScreen(Screen)(A0) 

RemakeDisplay()() 

RethinkDisplay()() 


Start of next next next next generation of names 


- 018C 
- 0192 
- 0198 


AllocRemember(RememberKey,Size,Flags)(A0,D0,D 1) 
AlohaWorkbench(wbport)(A0) 
FreeRemember(RememberKey ReallyForget)(A0,D0) 


Start of 15 Nov 85 names 


- 019E 
- 01A4 


LockIBase(dontknow )/(D0) 
UnlockIBase(IBLock)(A0) 


Start of post-1.1 names 


-01AA GetScreenData(buffer,size,type,screen)(A0,D0,D1,A1) 

- 01B0 RefreshGList(Gadgets,Ptr,Reg,NumGad)(A0/A 1/42,D0) 

-01B6 AddGList(AddPtr,Gadget,Position, NumGad,Reguester) 
(A0/A 1,D0/D 1/42) 

- 01BC RemoveCList(RemPtr,Gadget,NumGad)(A0/A1,D0) 

- 01C2 ActivateWindow(Window )(A0) 

-01C8 RefreshWindowFrame( Window )(A0) 

- OICE ActivateGadget(Gadgets, Window Reg)(A0/A 1/A2) 

- 01D4 NewModifyProp(Gadget,Ptr,Reg,Flags,HPos, VPos,HBody,VBody, 
NumGad)(A0/A 1/42,D0/D1/D2/D3/D4/D5) 

Offsets: layers.lib 

Layerlib routines 

- O01E InitLayers(li) (AO) 

- 0024 CreateUpfrontLayer(li,bm,x0,y0,x1,y1 flags,bm2) 
(A0/A1,D0/D1/D2/D3/D4,A2) 

- 002A CreateBehindLayer(li,bm,x0,y0,x1,yl,flags,bm2) 
(A0/A1,D0/D1/D2/D3/D4,A2) 

- 0030 UpfrontLayer(li,layer)(AO/A 1) 

- 0036 BehindLayer(li layer)(AO/A 1) 

- 003C MoveLayer(li,layer,dx,dy)(A0/A 1,D0/D 1) 

- 0042 SizeLayer(li layer,dx,dy)(A0/A1,D0/D1) 
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- 0048 ScrollLayer(li layer,dx,dy)(A0/A1,D0/D1) 
- 004E BeginUpdate(layer)(A0) 

- 0054 EndUpdate(layer,flag)(A0,d0) 

- O0SA DeleteLayer(li,layer)(A0/A 1) 

- 0060 LockLayer(li,layer)(A0/A 1) 

- 0066 UnlockLayer(layer)(A0) 

- 006C LockLayers(li)(A0) 

- 0072 UnlockLayers(li)(A0) 

- 0078 LockLayerlInfo(li)(A0) 

- 007E SwapBitsRastPortClipRect(rp,cr)(A0/A 1) 
- 0084 WhichLayer(li,x,y)(a0,d0/d1) 

- 008A UnlockLayerlnfo(li)(A0) 

- 0090 NewLayerlnfo(X() 

- 0096 DisposeLayerlnfo(li)(a0) 

- 009C FattenLayerInfo(li)(a0) 

- 0042 ThinLayerlnfo(li)(a0) 

- 0048 MoveLayerInFrontOf(layer to move.layer to be infront of)(a0/a1) 
- 00AE InstallClipRegion(layer.region)(a0/a1) 


Offsets: mathffp.lib 


- 001E SPFix(float)(D0) 

- 0024 SPFlt(integer)(D0) 

- 002A SPCmpl(leftFloat,rightFloat)(D1,D0) 
- 0030 SPTst(float)(D1) 

- 0036 SPAbs(float)(D0) 

- 003C SPNeg(float)(D0) 

- 0042 SPAdd(leftFloat,rightFloat)(D1,D0) 
- 0048 SPSub(leftFloat,rightFloat)(D1,D0) 

- 004E SPMul(leftFloat,rightFloat)(D1,D0) 

- 0054 SPDiv(leftFloat,rightFloat)(D1,D0) 

- 005A SPFloor(float (DO) 

- 0060 SPCeil(float)(D0) 


Offsets: mathieeedoubbas.lib 


- 001E IEEEDPFix(integer,integer)/(D0,D1) 

- 0024 IEEEDPFIt(integer)(D0) 

- 002A IEEEDPCmp(integer.integer,integer,integer)(D0,D1,D2,D3) 
- 0030 IEEEDPT'st(integer,integer (D0,D1) 

- 0036 IEEEDPAbs(integer,integer)(D0,D1) 

- 003C IEEEDPNeg(integer,integer)/(D0,D1) 

- 0042 IEEEDPAdd(integer,integer,integer,integer)(D0,D1,D2,D3) 
- 0048 IEEEDPSub(integer.integer,integer,integer)(D0,D1,D2,D3) 
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- 004E 
- 0054 
- 005A 
- 0060 


Offsets: 


- 001E 
- 0024 
- 002A 
- 0030 
- 0036 
- 003C 
- 0042 
- 0048 
- 004E 
- 0054 


Offsets: 


- 001E 
- 0024 
- 002A 
- 0030 
- 0036 
- 003C 
- 0042 
- 0048 
- 004E 
- 0054 
- 005A 
- 0060 
- 0066 
- 006C 


IEFEDPMUul(integer,integer,integer,integer)(D0,D1,D2,D3) 
IEEEDPDiv(integer,integer,integer,integer)(D0,D1,D2,D3) 
IEEEDPFloor(integer,integer)(D0,D1) 
IEEEDPCeil(integer,integer)(D0,D1) 


mathieeesingbas.lib 


IEEESPFix(float)(D0) 
IEEESPFIlt(integer)(D0) 
IEEESPCmp(leftFloat,rightFloat)(D0,D1) 
IEEESPTst(float)(DO) 
IEEESPAbs(float)(DO0) 
IEEESPNeg(float)(DO) 
IEEESPAdd(leftFloat,rightFloat)(D0,D 1) 
TIEEESPSub(leftFloat,rightFloat)(D0,D1) 
IEEESPMul(leftFloat,rightFloat)(D0,D 1) 
IEEESPDiv(leftFloat,rightFloat)(D0,D 1) 


mathtrans.lib 


SPAtan(float)(D0) 

SPSin(float)(DO) 

SPCos(float)(D0) 

SPTan(float)(DO) 
SPSincos(leftFloat,rightFloat)(D1,D0) 
SPSinh(float)(D0) 
SPCosh(float)(D0) 
SPTanh(float)(D0) 
SPExp(float)(D0) 

SPLog(float)(DO) 
SPPow(leftFloat,rightFloat)(D1,D0) 
SPSgrt(float)(D0) 
SPTieee(float)(DO) 
SPFieee(integer)(D0) 


New functions added for Release 1.1 


- 0072 
- 0078 
- 007E 


SPAsin(float)(D0) 
SPAcos(float)(D0) 
SPL0g10(float)(D0) 


Offsets: potgo.lib 


- 0006 
- 000C 
- 0012 


AllocPotBits(bits)(DO) 
FreePotBits(bits)(D0O) 
WritePotgo(word,mask)(D0,D 1) 
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Käyttöjärjestelmärutiinien kutsuminen 


Offsets: romboot.lib 
- 001E RomBoot() 


Offsets: timer.lib 


- 002A AddTime(dest,src)(A0/A 1) 
- 0030 SubTime(dest.src)(A0/A 1) 
- 0036 CmpTime(dest,sre)(A0/A 1) 


Offsets: translator.lib 


- O01E Translate(inputString,inputLength,outputBuffer,bufferSize) 
(A0,D0/A1,D 1) 
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Liite C 
Amigan kovo 


A ie kovo sisältää varsinaisen keskusyksikön lisäksi useita muita koneen ominai- 
suuksia parantavia IC-piirejä. Näitä ovat Agnus, Paula ja Denise, jotka muodosta- 
vat Amigan grafiikan ja äänen sekä huolehtivat useista muista toiminnoista, kuten levy- 

asemista ja sarjaväylästä. Lisäksi kovoon kuuluu tietysti myös tavanomaisia liityntäpiire- 
jä, jotka ovat tyyppiä 8520 (läheistä sukua 6526-piireille). 


Keskusyksikkö 


Itse MC68000 toimii Amigassa 7.14 megahertsin kellotaajuudella ja pystyy osoitta- 
maan jopa 9,5 megatavua RAM-muistia. Loppu kuudentoista megatavun muistiavaruu- 
desta on varattu käyttöjärjestelmälle, liitäntäpiireille ja I/O-laajennuksille. MC68000 voi- 
daan haluttaessa korvata hieman tehokkaammalla versiolla, MC68010:lla. Tällöin kaikki 
ohjelmat (lähinnä pelit) eivät kuitenkaan välttämättä toimi. Keskusyksikkö voidaan korva- 
ta myös kortilla, joka sisältää esimerkiksi erittäin tehokkaan MC68020-prosessorin ja arit- 
metiikkayksikön MC68881 (jotka voivat molemmat toimia vaikkapa 14 megahertsin kel- 
lotaajuudella) sekä nopeaa RAM-muistia. Kaikista muutoksista seuraa kuitenkin yleensä 
jonkinasteisia yhteensopivuusongelmia, joista kannattaa ottaa selvää ennen laajennusten 
hankkimista. 


Tilauspiirit 

Kolme tilaustyönä Amigaan suunniteltua piiriä, Agnus, Paula ja Denise, muodostavat 
yhtenäisen kokonaisuuden ja niitä voidaankin ohjelmoijan kannalta pitää yhtenä erittäin 
suurena integroituna piirinä. Piirit sisältävät mm. seuraavat toiminnalliset yksiköt: 

- grafiikkajärjestelmän, jonka resoluutio voi vaihdella välillä 320x200...640x512 pikse- 
liä, värejä voi olla näytössä samanaikaisesti jopa 4096 kpl. 

- apuprosessorin, jonka toiminta on tahdistettu näytön elektronisuihkuun. Apuproses- 
sori (Copper) voi vaihtaa esimerkiksi näytön väripalettia reaaliajassa sekä vaihtaa grafii- 
kan resoluutiota, kehittää keskeytyspyyntöjä pääprosessorille ja ohjata blitterin toimintaa. 

- värirekisterit (32 kpl), joilla määritellään näytössä käytettävät värit. 

Rekisterit sisältävät neljä bittiä jokaista värikomponenttia (punainen, vihreä ja sininen) 
kohti, joten jokaisen värikomponentin määrän syntyvässä värissä voi määrätä kuudessa- 
toista portaassa. Värien kokonaismäärä on 16*16*16 eli 4096 väriä. 

- spritegeneraattorit, jotka voivat tuottaa 16 pikseliä leveitä, halutun korkuisia liikutel- 
tavia yksiköitä näyttöön. Generaattoreita on kahdeksan, mutta niitä voidaan käyttää 
useampaan kertaan Copper-apuprosessorin ansiosta, joten spritejen määrä ei ole rajoitettu 
generaattorien määrään. Sprite voi sisältää korkeintaan kolmea väriä ja "läpinäkyviä" alu- 
eita, mutta liittämällä kaksi spriteä yhteen voidaan käyttää jopa viittätoista väriä. Spritet 
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saadaan näkymään joko taustakuvan päällä, sen takana tai siltä väliltä. 

- blitterin, joka on erittäin nopea graafisen tiedon käsittelijä. Blitter voi siirtää kak- 
siulotteisia muistialueita kolmesta lähteestä yhteen kohteeseen ja muodostaa lähteiden vä- 
lillä 256 erilaista loogista operaatiota ennen tuloksen sijoittamista kohteeseen. Lisäksi 
blitter osaa mm. piirtää viivoja ja täyttää alueita. 

- Blitter käyttää muistiosoituksiinsa ns. DMA (Direct Memory Access) -tekniikkaa, 
jonka ansiosta sen nopeus on erittäin suuri (esimerkiksi viivan piirrossa n. miljoona pikse- 
liä sekunnissa). 

- neljä äänikanavaa, jotka muodostuvat kukin omasta DMA- kanavastaan ja 8-bittises- 
tä D/A-muuntimestaan. Lisäksi jokaiseen kanavaan kuuluu 6-bittinen äänenvoimakkuus- 
säätö. Jokainen kanava pystyy toistamaan muistista digitoitua signaalia täysin itsenäisesti 
ilman keskusyksikön apua, mutta ne voivat myös keskeyttää MC68000:n pyytääkseen si- 
tä esimerkiksi kertomaan seuraavan soitettavan nuotin tiedot. Kanavat voidaan yhdistää 
pareittain, jolloin tuotettavan äänen amplitudia ja taajuutta voidaan moduloida automaatti- 
sesti. 

- Kanavat voivat toistaa jopa 28000 näytettä sekunnissa ilman, että MC68000:n toi- 
minta hidastuu lainkaan. 

- DMA-kanavan levyasemia varten. Järjestelmä pystyy lukenmaan ja kirjoittamaan ko- 
ko uran kerralla (toimintoja ei tarvitse suorittaa sektoreittain). 

- yhteensä 25 DMA-kanavaa tiedon hakemiseksi muistista kuvaa, spritejä, levyasemia, 
ääntä ja blitteriä varten. 

- keskeytysten hallintayksikön, joka vastaanottaa keskeytyspyynnöt muilta laitteilta ja 
välittää ne edelleen keskusyksikölle seitsemään eri tasoon ryhmiteltynä. 

Tilauspiirit osoittavat muistia siten, että normaalisti MC68000:n käyttöön jää kaikki 
sen tarvitsemat muistijaksot. Joskus esimerkiksi blitter kuitenkin tarvitsee enemmän muis- 
tijaksoja ja pyytää siksi prosessoria odottamaan hetken. Blitter kuitenkin suorittaa toimin- 
tonsa huomattavasti nopeammin kuin MC68000 pystyisi vastaavan tehtävän hoitamaan, 
joten tästä ei ole haittaa. 

Kuitenkin käytettäessä 640 pikselin vaakaresoluutiota ja kahdeksaa tai kuuttatoista vä- 
riä näyttö tarvitsee niin paljon tietoa, että MC68000:aa joudutaan jonkin verran hidasta- 
maan. 

Jos koneeseen on lisätty laajennusmuistia (ns. FAST RAM), keskusyksikön toiminta 
nopeutuu jonkin verran. Tilauspiirit nimittäin pystyvät hakemaan tietoa vain ns. CHIP 
RAM -alueelta, joka on nykyisin kooltaan 512 kilotavua. Tämän yli menevä osa on pro- 
sessorin yksityisomaisuutta, jota se voi käyttää täysin tilauspiireistä riippumatta. Tilaus- 
piirit eivät siis hidasta keskusyksikön toimintaa missään tilanteessa, jos keskusyksikkö 
osoittaa vain FAST-tyyppistä muistia. 

Jäljempänä on lueteltu kaikki tilauspiirien rekisterit, niiden merkitykset ja osoitteet. 

Tilauspiirien rekisterien käyttäminen suoraan omissa ohjelmissa ei ole suositeltavaa, 
koska se vahingoittaa koneen moniajoympäristöä. Sen sijaan kaikkia koneen toimintoja 
olisi pyrittävä käyttämään käyttöjärjestelmän välityksellä, jolloin myös muiden ohjelmien 
toiminta samanaikaisesti on mahdollista. 


182 


Amigan kovo 


Liitäntäpiirit 

Molemmat sisältävät kaksi kaksisuuntaista 8-bittistä I/O-porttia, synkronisen sarjaportin, 
kaksi ohjelmoitavaa 16-bittistä ajastinta, 24-bittisen laskurin ja keskeytyslogiikan. Liitän- 
täpiireillä hoidetaan mm. levyasemien ja RS232C-portin kontrollisignaalit, Centronics- 
portti ja näppäimistön luku. 

Liitäntäpiirien kellotaajuus in 1/10 keskusyksikön kellotaajuudesta eli n. 0,714 MHz. 
Tämä johtuu siitä, että MC68000 tukee 6800-tyyppisten oheispiirien käyttöä vain kym- 
menesosalla omasta kellotaajuudestaan. Haittapuolena on, että MC68000:n toiminta hi- 
dastuu jonkin verran liitäntäpiirien osoittamisen ajaksi. Normaalisti tästä ei kuitenkaan 
ole haittaa, mutta haluttaessa siirtää tietoa erittäin suurella nopeudella Centronics-portin 
kautta on otettava huomioon hidas IO-portin osoitus. 

Liitäntäpiirien käyttö selviää tarkemmin jäljempänä olevista taulukoista. 

Liitäntäpiireihin pätee sama kuin tilauspiireihinkin: Niiden käyttäminen ohi käyttöjär- 
jestelmärutiinien voi sekoittaa koneen toiminnan täysin. Esimerkiksi Centronics-portin 
käyttäminen ilman, että siitä kerrotaan käyttöjärjestelmälle, saattaa estää esimerkiksi levy- 
asemien toiminnan, koska keskeytysjärjestelmä menee sekaisin. Liitäntäpiirejä käytettäes- 
sä täytyy tarvittavat toiminnat ensin varata omaan käyttöönsä OpenResources-rutiinin 
avulla. 


Muistikartat 


Seuraavassa on esitetty tämänhetkisten Amigan I/O-piirien rekisterit, niiden toiminta 
ja osoitteet. Agnuksen, Paulan ja Denisen rekisterien osoitteisiin on lisättävä $dff000, jol- 
loin saadaan varsinainen muistiosoite. Siten esimerkiksi ensimmäisen värirekisterin osoi- 
te on $dff180. 

Muistikarttoja, rekisterien sisältöjä ja selityksiä ei ole yritetty kääntää suomeksi. Tulos 
olisi kuitenkin ollut epämääräistä suomen ja englannin sekoitusta, josta olisi vielä vai- 
keampi saada selvää kuin alkuperäisestä englanninkielisestä tekstistä. 
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egister Address 


AUTxLCH 0R0 
AUDXLCL 0R2 


AUDXLEN — 0A4 


Register Summary — Alphabetical Order 


Read/ Dantso/ 
Write Paula 


w Pp Audio, disk, control write 
R Pp Audio, disk, control read 
BIT USE 
15 SET/CLR Set/clear control bit. Determines if bits 


written vith a 1 get set or cleared. Bits 
written with a zero are always unchanged. 
14-13 PRECOMP 1-0 CODE PRECOMP VALUE 


00 none 
01 140ns 
10 280 ns 
11 560 ns 
12 MFMPREC ( 1=MFM precomp 0=GCR precomp) 
11 UARTBRK Forces a UART break (clears TXD) if true. 
10 WORDSYNC Enables disk read synchronizing on a word 
egual to DISK SYNC CODE, located in 
address (3E)*2. 
09 MSBSYNC Enables disk read synchronizing on the MSB 


(most. signif bit). Appl type CCR. 
08 FAST — Disk data clock rate control l=fast(2us) 0=slow(4us). 
(fast for MEM, slow for MFM or CCR) 


07 USE3PN Use audio channel 3 to modulate nothing. 

06 USE2P3 Use audio channel 2 to modulate period of channel 3. 
05 USE1P2 Use audio channel 1 to modulate period of channel 2. 
04 USEOP1 Use audio channel 0 to modulate period of channel 1. 


03 USE3VN Use audio channel 3 to modulate nothing. 

02 USE2V3 Use audio channel 2 to modulate volume of channel 3. 

01 USE1V2 Use audio channel 1 to modulate volume of channel 2. 

00 USEOV1 Use audio channel 0 to modulate volume of channel 1. 
NOTE: 1f both period and volume are modulated on the 
same channel, the period and volume will be alternated. 
Eirst word xw00000x V6-V0 , Second word P15-P0 (etc) 


W A Audio channel x location (high 3 bitsi 

w A Audio channel x location (low 15 bits] 

This pair of registers contains the 18 bit starting address 
(location) of audio channel x (x=0,1.2.3) DMA data. 

his is not a pointer register and therefore needs 

to be reloaded only 1f a different memory location is to 
be outputted. 


W P Audio channel x length 
This register contains the length (number of words) of 
audio channel x DMA data. 


AUDXPER 


AUDXVOL 


AUDXDAT 


BLTxPTH 
BLTxPTL 


BLTxMOD 


0R6 


0R8 


OA 


050 
052 


064 


W P Audio channel x Period 

'Mis register contains the perioä (rate) of 

audio channel x DMA data transfer. 

The minimum period is 124 color clocks. This means 
that the smallest number that should be placed in 
this register is 124 decimal. This corresponds to 
a maximum sample freguency of 28.86 khz. 


W P Audio channel x volume 

This register contains the volume setting for 
audio channel x. Bits 6,5,4,3,2,1,0 specify 65 
linear volume levels as shown below. 


15-07 Not used 

06 Forces volume to max (64 ones, no zeros) 

05-00 Sets one of 64 levels (000000=n0 output 
(111111=63 1s, one 0) 


w P Audio channel x data 

This register is the audio channel x (x=0,1,2,3) 
DMA data buffer. It contains 2 bytes of data that 
are each 2's lement: and are outputted 
seguentially (with digital-to-analog conversion) 
to the audio output pins. (LSB = 3 MV) The DMA 
controller automatically transfers data to this 
register from RAM. "The processor can also write 
directly to this register. When the DMA data is 
finished (words outputted=length) and the data in 
this register has boen used, an audio channel 
4nterrupt reguest is set. 


W A Blitter pointer to x (high 3 bits) 

W A Blitter pointer to x (low 15 bits) 
'Ihis pair of registers contains the 18-bit address 
of blitter source (x=A,B,C) or destination (x=D) 
DMA data. This pointer must be preloaded with the 
starting address of the data to be processed by 
the blitter. After the blitter is finished, it 
will contain the last data address (plus increment 
and modulo) . 

LINE DRAW —BLTAPTL is used as an accumulator 
LINE DRAW — register and must be preloaded with 
LINE DRAW the starting value of (2Y-X) where 
LINE DRAW —=Y/X is the line slope. BLTCPT and 
LINE DRAW —BLTDPT (both H and L) must be 

LINE DRAW —preloaded with the starting address 
LINE DRAW of the line. 


w A Blitter modulo x 

'Mis register contains the modulo for blittor 
source (x=A,B,C) or destination (x=D). A modulo 
is a number that is automatically added to the 
address at the end of each line, to make the 


040) ULSILIY 


S$I 


BLTAFWM 
BLTALWM 


BLTxDAT 


BLTDDAT 


BLTCON0 
BLTCON1 


€-V 


074 


040 W A 
042 W A 


each to be a different size, while an identical 
area of each is used in the blitter operation. 
LINE DRAW —BLTAMOD and BLTBMOD are used as slope 


LINE DRAW — storage registers and must be preloaded 


LINE DRAW with the values (4Y-4X) and (4Y) 
LINE DRAW — respectively. Y/X= line slope. 
LINE DRAW —BLTCMOD and BLTDMOD must both be 
LINE DRAW —preloaded with the width (in bytes) 
LINE DRAW —of the image into which the line is 
LINE DRAW — being drawn (normally two times the 
LINE DRAW —scroen width in words). 


W A Blitter first-vord mask for source A 
w A Blitter last-word mask for source A 
The patterns in these two registers are ANDed with 
the first and last words of each line of data from 
source A into the blitter. A zero in any bit 
overrides data from source A. These registers 
should be set to all 1s for fill mode or for 
line-drawing mode. 


W A Blitter source x data register 
'This register holds source x (x=A,B,C) data for 
use by the blitter. It is normally loaded by the 
blitter DMA channel; however, it may also be 
preloaded by the microprocessor. 

LINE DRAW —BLTADAT is used as an index register 
LINE DRAW — and must be preloaded with 8000. 
LINE DRAW —BLTBDAT 1s used for texture; it mist 
LINE DRAW be preloadod with FF 1f no textura 
LINE DRAW — (solid line) is desired. 


Blitter destination data register 
This register holds the data resulting from each 
word of blitter operation until it is sent toa 
RAM destination — This is a dummy address and 
cannot be read by the micro. The transfer is 
automatic during blitter operation. 


Blitter control register 0 

Blitter control register 1 

These two contrc1 registers are used together to 
control blitter operations. There are two basic 
modes, area and line, which are selected by bit 
0 of BLTCON1, as shown below. 


BLTOONO BLTOON1 
ASt3 BSH3 
ASH2 BSH2 
as BSH1 
KSA0 BSHO 
USFEA x 
USEB x 
USEC x 

USED x 

1E7 x 

LEG6 x 

LFS x 

LF4 EEE 
1E3 IFE 
LF2 FCI 

LF1 DESC 
LEO LINE (=0) 


ASH3-0 Shift value of A source 


BSH3-i 


USEA 


0 Shift value of B source 
Mode control bit to use source A 
Mode control bit to use source B 
Mode control bit to use source € 
Mode control bit to use destination D 


LF7-0 Logic function minterm select lines 


LINE 
LINE DRAW 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 


Exclusive fill enable 
Inclusive fill enable 


Fi11 carry input 


Descending (decreasing address) control it 
Line mode control bit (set to 0) 
vy! LINE MODE (line draw) 
DRAW BIT BLTCONO BLTCON1 
DRAW 2 SR25 Sa anaTmI! 0 Ennsten 
DRAW 15 —START3 TEXTURE3 
DRAW 14 —START2 TEXTURE2 
DRAW 13 STARTI TEXTURE1 
DRAW 12 —STARTO TEXTUREO 
DRAW 11 1 (U 
DRAW 10 0 0 
DRAW 09 1 o 
DRAW 08 1 0 
DRAW 07 LET 0 
DRAW 06 LEG6 SIOCN 
DRAW 05 —LFS 0 (Reserved) 
DRAW 04 Lra SUD 
DRAW 03 LFE3 SUL 
DRAN 02 LF2 RUL 
DRAW 01 LF1 SING 
DRAW 00 —LFO LINE (=1) 
DRAW 


040) ULSILIY 


9ST 


p-V 


BLTSIZE 


058 


LINE DRAW START3-0 Starting point of line 
LINE DRAW (0 thru 15 hex) 

LINE DRAW LF7-0 Logic function minterm 
LINE DRAW select lines should be preloaded 
LINE DRAW with 4A to select the eguation 
LIIE DRAW D= (AC+ABC) . Since A contains a 
LINE DRAW single bit true (8000), most bits 
LINE DRAW Will pass the C field unchanged 
LINE DRAW (not A and C), but one bit will 
LINE DRAW invert the C field and combine it 
LINE DRAW with texture (A and B and not C). 
LINE DRAW The A bit is automatically moved 
LINE DRAW across the word by the hardware. 
LINE DRAW 

LINE DRAW LINE — Line mode control bit 
LINE DRAW (set to 1) 

LINE DRAW SICN — Sign flag 

LINE DRAW o Reserved for new mode 
LINE DRAW SING Single bit per horizontal 
LINE DRAW line for use with subseguent 
LINE DRAW area fill 


LINE DRAW SUD — Sometimes up or down (=AUD*) 
LINE DRAW SUL — Sometimes up or left 

LINE DRAW AUL — Alvays up or left 

LINE DRAW The 3 bits above select the octant 
LINE DRAW for line drawing: 

LINE DRAW SUD SUL AUL 

LINE DRAW - - --- 

LINE DRAW 
LINE DRAW 
LINE DRAW 
LINE DRAW 
LINE DRAW 
LINE DRAW 
LINE DRAW 
LINE DRAW 
LINE DRAW 
LINE DRAW 


1 0 


veunro! 8 
HoorHHoo 
OoroHHOH 
CY-Y-YSYSTSIS 


Ja 


The "B" source is used for 
texturing the drawn lines. 


W A Blitter start and size (window width, 
height) 

This register contains the width and height of 

the blitter operation (in line mode, width must 

= 2, height = line length). Writing to this 

register will start the blitter, and should be 

done last, after all pointers and control 

registers have been initialized. 

BITH 15,14,13,12,11,10,09,08,07,06,05,04,03,02,01,00 
h9 h8 h7 h6 h5 h4 h3 h2 hl h0,wS vd w3 w2 wl w0 

h=height=vertical lines (10 bits=1024 lines max) 


w=width =horizontal pixels (6 bits=64 words=1024 pixels max) 


LINE DRAW —BLTSIZE controls the line length and starts 
LINE DRAW the line draw when written to. Theh field 
LINE DRAW controls the line length (10 bits gives 
LINE DRAW lines up to 1024 dots long). The w field 
LINE DRAW = must be set to 02 for all line drawing. 


BPLxPTH 
BPLxPTL 


BPL1MOD 
BPL2MOD 


BPLCON0 
BPLCON1 
BPLCON2 


0E0 
0E2 


110 


108 
10A 


100 
102 
104 


W A Bit plane x pointer (high 3 bits) 

w A Bit plane x pointer j10w 15 bits) 

This pair of registers contains the 18-bit pointer to 
the address of bit-plane x (x=1,2,3,4,5,6) DMA data. 
This pointer must be reinitialized by the processor 
or copper to point to the beginning of bit plane data 


every vertical blank time. 
W D Bit plane x data (parallel-to-serial 
convert) 
These registers receive the DMA data fetched from 
RAM by the bit plane address pointers described 
above. They may also be written by either 
microprocessor. They act as a six-word parallel- 
to-serial buffer for up to six memory bit planes 
(x=1-6). The parallel-to-serial conversion is 
triggered whenever bit plane $1 is written, 
indicating the completion of all bit planes for 
that vord (16 pixels). The MSB is output first, 
and is, therefore, always on the left. 


w A Bit plane modulo (odd planes) 

w A Bit Plane modulo (even planes) 

These registers contain the modulos for the odd 
and even bit planes. A modulo is a number that is 
automatically added to the address at the end of 
each line, so that the address then points to the 
start of the next line. 

Since they have separate modulos, the odd and even 
bit planes may have sizes that are different from 
each other, as well as different from the display 
window size. 


Ww AD Bit plane control register (misc. 
control bits) 

W D Bit plane control register 
(horizontal scroll control) 

W D Bit Plane control register 


(video priority control) 
These registers control the operation of the 
bit planes and various aspects of the display. 


BITW BPLCON0O BPLCON1 BPLCON2 
15 HIRES x x 

14 BPU2 x x 

13 BPU1 x x 

12 BPU0O x x 

11 HOMOD x x 

10 DBLPF x x 

09 COLOR x x 

08 GAUD x x 

07 x PF2H3 x 

06 x PF2H2 PF2PRI 
05 x PF2H1 PF2P2 
04 x PF2H0 PE2P1 


03 LPEN PF1H3 PE2P0 


040) UPSIUIV 


L8ST 


CLXCON 


098 


02 LACE PF1H2 PF1P2 
01 ERSY PF1H1 PF1P1 
00 x PE1H0 PE1P0 


HIRES=High-resolution (640) mode 
BPU =Bit plane use code 000-110 (NONE through 6 inclusive) 
HOMOD=Hold-and-modify mode 
DBLPF=Double playfield (PF1=0odd PF2=even bit planes) 
COLOR=Composite video COLOR enable 
GAUD=-Genlock audio enable (muxed on BKCND pin 
during vertical blanking 
LPEN =Light pen enable (reset on power up) 
LACE sinterlaoa enable (reset on power 


inputs) (reset on power up) 
PE2PRI=Playfield 2 (even planes) has priority over 
(appears in front of) playfield 1 
(odd planes). 
PE2P=Playfield 2 priority code (with respect 
to sprites) 
PF1P=Playfield 1 priority code (with respect 
to sprites) 
PE2H=Playfield 2 horizontal scroll code 
PFE1H=Playfield 1 horizontal scroll code 


WD Collision control 

Mis register controls which bit-planes are 
included (enabled) in collision detection and 
their reguired state 1f included. It also controls 
the individual inclusion of odd-numbered sprites 
in the collision detection by logically OR-ing 
them with their corresponding even-numbered sprite. 
BIT FUNCTION DESCRIPTION 


15 — ENS?7 Enable sprite 7 (ORed with sprite 6) 

14 — ENSPS Fnable sprite 5 (ORed with sprite 4) 

13 — ENSP3 znable sprite 3 (ORed with sprite 2) 

12 ENSP1 Enable sprite 1 (ORed with sprite 0) 

11 — ENBP6 Enable bit plane 6 (match reguired 
for collision) 

10 — ENBPS Enable bit plane 5 (match reguired 
for collision) 

09 — ENRPA Enable bit plane 4 (match reguired 
for collision) 

08 — ENBP3 Enable bit plane 3 (match reguired 
for collision) 

07 — ENBP2 Enable bit plane 2 (match reguired 
for collision) 

06 — ENRP1 Enable bit plane 1 (match reguired 


for collision) 


05 MVBP6 Match value for bit plane 6 collision 
04 MBPS Match value for bit plane 5 collision 
03 MVBP4 Match value for bit plane 4 collision 
02 MVBP3 Match value for bit plane 3 collision 
01 Mmar2 Match value for bit plane 2 collision 
00 MvRP1 Match value for bit plane 1 collision 


CLXDAT 


COLOR»xx 


COPCON 


00E R D 


180 


02E 


NOTE: Disabled bit planes cannot prevent 
collisions. Therefore if all bit planes are 
disabled, collisions will be continuous, 
regardless of the match values. 


Collision data register (read and clear) 
This address reads (and clears) the collision 
detection register. The bit assignments are below. 
NOTE: Playfield 1 is all odd-numbered enabled 
bit planes. Playfleld 2 is all even-numbered 
enabled bit planes 
BIMW OOLLISTONS REGISTERED 


15 not used 
14 Sprite 4 (or 5) to sprite 6 (or 7) 


13 Sprite 2 (or 3) to sprite 6 (or 7) 
12 Sprite 2 (or 3) to sprite 4 (or 5) 
n Sprite 0 (or 1) to sprite 6 (or 7) 
10 Sprite 0 (or 1) to sprite 4 (or 5) 
09 Sprite 0 (or 1) to sprite 2 (or 3) 
08 Playfield 2 to sprite 6 (or 7) 

07 Playfield 2 to sprite 4 (or 5) 

06 Playfield 2 to sprite 2 (or 3) 

05 Playfield 2 to sprite 0 (or 1) 

04 Playfield 1 to sprite 6 (or 7) 

03 Playfield 1 to sprite 4 (or 5) 

02 Playfield 1 to sprite 2 (or 3) 

01 Playfield 1 to sprite 0 (or 1) 

00 Playfield 1 to playfield 2 

W D Color table xx 


There are 32 of thesa registers (xx=00-31) and they 
are sometimes collectively called the "color 
palette." They contain 12-bit codes representing 
red, green, and blue colors for RCB systems. 

One of these registers at a time is selected 

(by the BPLxDAT serialized video code) 

for presentation at the RCB video output pins. 

The table below shows the color register bit usage. 
BITX 15,14,13,12,11,10,09,08,07,06,05,04,03,02,01,00 
RCB X X X X R3 R2 R1 RO G3 G2 C1 Go B3 B2 81 B0 
B-blue, C=green, R=red, 


W A Copper control register 

This is a 1-bit register that when set true, allows 

the Copper to access the blitter hardvare. This 

bit is cleared by power-on reset, so that tha 

Copper cannot access the blitter hardware. 

BIT% NAME FUNCTION 

01 CDANC Copper danger mode. Allows Copper 
access to blitter if true. 


0403 ULSIUIVY 


881 


COPJMP1 
COPJMP2 


COP1LCH 
COP11ICL 
COP2LCH 
COP2LCL 


COPINS 


088 
08A 


08c 


S A Copper restart at first location 

Ss A Copper restart at second location 
These addresses are strobe addresses. When written 
to, they cause the Copper to jump indirect using 
the address contained in the first or second 
location registers described below. The Copper 
itsalf can write to these addresses, causing its 
own jump indirect. 


A Copper first location register 
(high 3 bits) 

Copper first location register 
(low 15 bits) 

Copper second location register 
(high 3 bits) 

Copper second location register 
(1ow 15 bits) 

These registers contain the jump addresses 
described above. 


x x x x£ 


A 
A 
A 


w A Copper instruction fetch identify 
This is a dummy address that is generated by the 
Copper whenever it is loading instructions into 
its own instruction register. This actually occurs 
every Copper cycle except for the second (IR2) 
cycle of the MOVE instruction. The three types 

of instructions are shown below. 

MOVE Move immediate to destination. 

WAIT Wait until beam counter is egual to, or 
greater than. (keeps Copper off of bus 
until beam position has been reached). 

SKIP — Skip 1f beam counter is egual to or 
greater than (skips following MOVE 
Änstruction unless beam position has 


been reached). 
WAIT UNTIL SKIP IF 

BIT 1R1 1R2 IR1 IR2 IR1 1R2 
15 x RD1S VP7 BED *% —VWP7 BED * 
14 x RD14 vP6 vE6 vP6 VE6 
13 x RD13 vP5 VES VPS VES 
12 x RD12 VP4 VE4 vP4 VE4 
11 x RD11 vP3 VE3 w3 VE3 
10 x RD10 VP2 VE2 VP2 VE2 
09 x RD09 vP1 VE1 VP1 VE1 
08 DA8 —RD08 vP0 VEO vP0 VEO 
07 DA7 —RD07 HP8 HE8 HP8 HE8 
06 DA6 —RD06 HP7 HET HP7 HE7 
05 DAS —RD05 HP6 HE6 HP6 HE6 
04 DA4 —RD04 HPS HES HPS HES 
03 DA3 —RD03 HP4 HE4 HP4 HE4 
02 DA2 —RD02 FP3 HE3 HP3 HE3 
01 DA1 —RD01 FP2 HE2 HP2 HE2 
00 o RD00 1 0 1 1 


DIWSTRT 
DIWSTOP 


IR1=First instruction register 

IR2=Second instruction register 

DA =Dostination address for MOVE instruction. 
Fetched during IR1 time, used during IR2 tima 
on RGA bus. 

RD =RAM data moved by MOVE instruction at IR2 time 

directly from RAM to the address given by the 
DA field. 

VP =Vertical beam position comparison bit. 

HP =Horizontal beam position comparison bit. 

VE =Enable comparison (mask bit). 

HE =Enable comparison (mask bit). 

* NOTE BFD=Blitter finished disable. When this bit 
is true, the Blitter Finished flag will 
have no effect on the Copper. When this 
bit is zero, the Blitter Finished flag 
must be true (in addition to the rest of 
the bit comparisons) befora tha Copper 
can exit from its wait state or skip 
over an instruction. Note that the V7 
comparison cannot be masked. 


The Copper is basically a two-cycle machine that 
reguests the bus only during odd memory cycles 

(4 memory cycles per instruction). This prevents 
collisions with display, audio, disk, refresh, and 
sprites, all of which use only even cycles. It 
therefore needs (and has) priority over only the 
blitter and microprocessor . 


There are only three types of instructions: 
MOVE immediate, WAIT until, and SKIP 1f. All 
instructions (except for WAIT) reguire two bus 
cycles (and two instruction words). Since only 
the odd bus cycles are reguested, four memory 
cycle times are reguired per instruction 
(memory cycles are 280 ns.) 


There are two indirect jump registers, COP1LC and 
COP2LC. These are 18-bit pointer registers whose 
Contents are used to modify the program counter for 
initialization or jumps. They are transferred to 
the program counter whenever strobe addresses 
COPJMP1 or COPJMP2 are written. In addition, 
COP1[C is automatically used at the beginning of 
each vertical blank time. 


It is important that one of the jump registers be 
initialized and its jump strobe address hit after 


power-up but before Copper DMA is initialized. 
This insures a determined startup address and state. 


08E W A Display window start (upper left 
vertical-horizontal position) 
090 w A Display window stop (lower right 


vertical-horizontal position) 
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(3.30 


-V 


E 


DDFSTRT 
DDFSTOP 


DMACON 
DMACONR 


092 
094 


096 
002 


These registers control display window size and 
position by locating the upper left and lower right 
Corners. 

BIT 15,14,13.12,11.10,09,08,07,06,05,04,03,02.,01,00 
USE V7 V6 VS V4 V3 V2 V1 Vo H7 H6 HS H4 H3 H2 H1 HO 
DIWSTRT is vertically restricted to the upper 2/3 

of the display (V8=0) and horizontally restricted to 
the left 3/4 of the display (H8=0). 

DIWSTOP is vertically restricted to the lower 1/2 
of the display (V8=/=V7) and horizontally restricted 
to the right 1/4 of the display (H8=1). 


w A Display data fetch start (horiz. position) 
Ww A Display data fetch stop (horiz. position) 
'These registers control the horizontal timing of the 
beginning and end of the bit plane DMA display data 
fetch. The vertical bit plane DMA timing is identical 
to the display windows described above. 

The bit plane modulos are dependent on the bit plane 
horizontal size and on this data-fetch window size. 


Register bit assignment 


n 
o 
S 
o 
» 
o 
e 
o 
-. 
o 
13 
o 
S 


BITH 15,14.13.12,11,10,09.08,07,0 
USE X X X X X X X X H8 H7 H6 HS H4H3 X X 
v 


(X bits should alvays be driven 
upward compatibility) 


"he tables below show the start and stop timing for 
different register contents. 


DDFSTRT (left edge of display data fetch) 


Extra wide (max) * 0 0 1 0 1 
Wide 0435 
Normal 0011 1 
Narrow 0100 0,0 


Narrow 1540407 07.4. 
Normal 11041 .0,0 
Wide (max) 4 100 LÄ 

W ADP DMA control write (clear or set) 

R A P DMA control (and blitter status) read 


This register controls all of the DMA channels and 
contains blitter DMA status bits. 


DSKPTH 
DSKPTL 


DSKLEN 


DSKDAT 
DSKDATR 


020 
022 


024 


026 
008 


BIT4 FUNCTION DESCRIPTION 


15 SET/CLR Set/clear control bit. Determines 
4f bits written witha 1 get set or 
cleared. Bits written with a zero 
are unchanged. 

14 BBUSY Blitter busy status bit (read only) 

13 BZERO Blitter logic zero status bit 
(read only). 

12 x 

11 x 

10 — BLTPRI Blitter DMA priority 
(over CPU micro) (also called 

'blitter nasty") (disables /BLS 
pin, preventing micro from 
stealing any bus cycles while 
blitter DMA is running). 

09 DMAEN Enable all DMA below 

08 BPLEN Bit plane DMA enable 

07 COPEN DMA enable 

06 BLTEN Blitter DMA enable 

05 SPREN Sprite DMA enable 

04 DSKEN Disk DMA enable 

03 AUD3EN Audio channel 3 DMA enable 

02 AUD2EN Audio channel 2 DMA enable 

01 AUDIEN Audio channel 1 DMA enable 

00 AUDOEN Audio channel 0 DMA enable 

w A Disk pointer (high 3 bits) 

W A Disk pointer (low 15 bits) 


This pair of registers contains the 18-bit 
address of disk DMA data. These address registers 
must be initialized by the processor or Copper 
before disk DMA is enabled. 


w P Disk length 

This register contains the length (number of words) 
of disk DMA data. It also contains two control 
bits, a DMA enable bit, and a DMA direction 


(read/write) bit. 
BIT& FUNCTION DESCRIPTION 


15 — DMAEN Disk DMA enable 
14 — WRITE Disk write (RAM to disk) 1f 1 
13-0 LENCTH Length (ft of vords) of DMA data. 
w P = Disk DMA data write 


ER P —Disk DMA data read (early read dummy 
address) 

This register is the disk DMA data buffer. It 

contains tvo bytes of data that are either sent 

(written) to or received (read) from the disk. 

The write mode is enabled by bit 14 of the LENGCTH 

register. The DMA controller automatically 

transfers data to or from this register and RAM, 

and when the DMA data is finished (length=0) it 

causes a disk block interrupt. See interrupts below. 
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061 


DSKBYTR 


DSKSYNC 


INTREO 
INTREOR 


INTENA 
INTENAR 


O1A 


07E 


09 
01E 


09A 
01c 


R P Disk data byte and status read 

This register is the disk-microprocessor data 
buffer. Data from the disk (in read mode) is 
loaded into this register one byte at a time, and 
bit 15 (DSKBYT) is set true. 


BIT 
15 — DSKBYT Disk byte ready (reset on read) 
14 DMAON Mirror of bit 15 (DMAEN) in DSKLEN, 
ANDed with B1t09 (DMAEN) in DMACON JOYODAT 
13 DISKWRITE Mirror of bit 14 (WRITE) in DSKLEN 
12 WORDEGUAL = This bit true only while the JOY1DAT 


DSKSYNC register eguals the data 


from disk. 
11-08 X Not used 
07-00 DATA Disk byte data 
W P Disk sync register, holds the match 
code for disk read synchronization. 
See ADKCON bit 10. 
W P Interrupt reguest bits (clear or set) 
R P Interrupt reguest bits (read) 


This register contains interrupt reguest bits (or 
flags). These bits may be polled by the processor; 
4f enabled by the bits listed in the next register, 
they may cause processor interrupts. Botha set and 
clear operation are reguired to load arbitrary data 
into this register. These status bits are not 
automatically reset when the interrupt is serviced, 
and must be reset when desired by writing to this 
address. The bit assignments are identical to the 
enable register below. 


W P Interrupt enable bits (clear or set bits) 
R P —Interrupt enable bits (read) 

This register contains interrupt enable bits. The bit 
assignment for both the reguest and enable registers 
is given below. 


BITW FUNCT LEVEL DESCRIPTION 


15 — SET/CIR Set/clear control bit. Determines 1f 
bits written with a 1 get set or 
cleared. Bits written with a zero 
are always unchanged. 

14 INTEN Master interrupt (enable only, 

n0 reguest) 

13 EXTER 6 External interrupt 

12 — DSKSYN 5 Disk sync register (DSKSYWC) 

matches disk data 

1 RBE 5 Serial port receive buffer full 

10 AUDI 4 — Audio channel 3 block finished 

09 , AUD2 4 Audio channel 2 block finished 

08 AUDI 4 Audio channel 1 block finished 

07 AUDO 4 — Audio channel 0 block finished 


00A 
00c 


06 BLIT 23 Blitter finished 

05 VERTB 3 Start of vertica" blank 

04 COPER 3 Copper 

03 PORTS 2 1/0 ports and timers 

02 SOFT 1 Reserved for software-initiated 

interrupt 

01 DSKBLK 1 Disk block finished 

00 TBE 1 Serial port transmit buffer empty 

R D Joystick-mouse (0 data (left vertical, 
horizontal) 

R D Joystick-mouse 1 data (right vertical, 
horizontal) 


"These addresses each read a pair of 8-bit mouse 
counters. (0=left controller pair, 1=right 
controller pair (four counters total). Thebit 
usage for both left and right addresses is shown 
below. Each counter is clocked by signals from 
two controller pins. Bits 1 and 0 of each counter 
may be read to determine the state of these two 
clock pins. This allows these pins to double as 
joystick switch inputs. 


Mouse counter usage: 

(pins 1,3=Yclock, pins 2,4=Xclock) 

BIT 15,14,13,12,11,10,09,08 07,06,05,04,03,02, 
ODAT Y7 Y6 YS Y4 Y3 Y2 Yl YO X7 X6 XS5 X4 X3 X2 
1DAT Y7 Yö YS Y4d Y3 Y2 Yl YO X7 X6 X5 X4 X3 X2 


01,00 
X1 X0 
X1 X0 
The following table shows the mouse/joystick 
Connector pin usage. The pins (and their functions) 
are sampled (multiplexed) into the DENISE chip 
during the clock times shown in the table. 

his table is for reference only and should 

not be needed by the programmer. (Note that the 
joystick functions are all "active low" at the 
Connector pins.) 

Conn — Joystick Mouse — ----------------- 
Pin Function Function Pin Name Clock 


11 FORW+ Y 38 —M0V at OCK 
13 LEFT* YO 38 —MOV at OCK* 
12 BACKA x 9 —M0OH at (CK 
IA — RIGH* xo 9 —MOH at CCK* 
R1 FORW* Y 39 —MIV at (CK 
R3 LEET* YO 39 —M1V at CCK* 
R2 BACKA x 8 MIHat (CK 
R4 — RICH* xo 8 MIHat OCK* 


After being sampled, these connector pin signals 
are used in guadrature to clock the mouse counters. 
The LEFT and RIGHT joystick functions (active high) 
are directly available on the Yl and X1 bits of 
each counter. In order to recreate the FORWARD 
and BACK joystick functions, however, it is 
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161 


POTODAT 
POTIDAT 


POTOOR 


036 


012 
014 


034 
016 


necessary to logically combine (exclusive OR) 
the lower two bits of each counter. 
This is illustrated in the following table. 


To detect Read these 
counter bits 

Forward Yl xor YO (BIT09 xor BIT408) 
Left Yl 
Back X1 xor XO (BIT01 xor BIT$00) 
Right x1 
w D Write to all four joystick-mouse counters 

at once. 
Mouse counter write test data: 
BIT 15,14,13,12,11,10,09,08 07,06,05,04,03,02,01,00 
ODAT OY? Y6 YS Y4 Y3 Y2 xx xx X7 X6 X5 X4 X3 X2 xx xx 
1DAT Y7 Y6 YS Y4 Y3 Y2 xx xx X7 X6 XS X4 X3 X2 xx xx 
R P Pot counter data left pair (vert,horiz) 
R P — Pot counter data right pair (vert,horiz) 


'These addresses each read a pair of 8-bit pot counters. 
(Four counters total.) The bit assignment for both 
addresses is shown below. The counters are stopped by 
signals from two controller connectors (left-right) 
with two pins each. 
BITW 15.14,13,12,11,10,09,08 07,06,05,04,03,02,01,00 
RICHT Y7 Y6 YS Y4 Y3 Y2 Yl YO X7 X6 X5 X4 X3 X2 X1 X0 
LEET Y7 Yö YS Y4 Y3 Y2 Yl YO X7 X6 X5 X4 X3 X2 X1 X0 
CONNECTORS 


Loc. Dir. Sym Pin 


RIGHT Y RY 9. 


RIGHT X RX 5 
LEFT OY LY 9 
LEFT X LX 5 
w P Pot port data write and start. 
R P —Pot port data read (formerly called POTINP). 


This register controls a 4-bit bi-directional 1/0 port 
that shares the same four pins as the four pot counters 
above. 


BIT FUNCT — DESCRIPTION 
15 — OUTRY — Output enable for Paula pin 36 
14 — DATRY — 1/0 data Paula pin 36 
13 — OUTRX — Output enable for Paula pin 35 
12 — DATRX —1/O data Paula pin 35 
11 — OUTLY — Output enable for Paula pin 33 
10 — DATLY — 1/0 data Paula pin 33 
09 — OUTLX — Output enable for Paula pin 32 


SERDATR 


028 


030 


018 


08 DATLX — 1/0 data Paula pin 32 

07-01 0 Reserved for chip ID code (presently 0) 

00 START — Start pots (dump capacitors, start 
counters) 


w A Refresh pointer 
This register is used as a dynamic RAM refresh 
address generator. It is writeable for test 
purposes only, and should never be written by 
the microprocessor. 


w P — Serial port data snd stop bits write 
(transmit data buffer) 
This address writes data to a transmit data buffer. 
Data from this buffer is moved into a serial shift 
register for output transmission whenever it is 
empty. This sets the interrupt reguest TBE 
(transmit buffer empty). A stop bit must be 
provided as part of the data word. The length of 
the data word is set by the position of the stop 
bit. 
BIT 15,14,13,12,11,10,09,08,07,06,05,04,03,02,01,00 
USE 0 000 0 0 S D8 D7 D6 DS D4 D3 D2 D1 D0 
Note: S= stopbit = 1, D = data bits. 


R P — Serial port data and status read 
(receive data buffer) 

This address reads data from a receive data buffer. 

Data in this buffer is loaded from a receiving 

shift register whenever it is full. Several 

interrupt reguest bits are also read at this 

address, along with the data, as shown below. 

BIT 


15 OVRUN Serial port receiver overrun. 
Reset by resetting bit 11 of 
INTREO. 

14 RBF Serial port receive buffar full 
(mirror). 

13 TBE Serial port transmit buffer 
empty (mirror). 

12 TSRE Serial port transmit shift 
register empty 
Reset by loading into buffer. 

11 RD RD pin receives UART serial 
data for direct bit test by 
the microprocessor. 

10 0 Not used 

09 = SP Stop bit 

08 SIP-DB8 Stop bit if LONG, data bit 1f 
not. 

07 DB7 Data bit 

06 DB6 Data bit 

05 DB5 Data bit 

04 DB4 Data bit 

03 DB3 Data bit 

02 —DB2 Data bit 

01 DB1 Data bit 

00 DB0 Data bit 
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01 -V 


SPRxPOS 


SPRxDATA 
SPRxDATB 


032 


120 
122 


140 
142 


144 
146 


W P Serial port period and control 

This register contains the control bit LONG referred to 
above, and a 15-bit number defining the serial port 
baud rate. If this number is N, then the baud rate is 

1 bit every (N+1)*.2794 microseconds. 

BI 

15 LONG 
14-00 RATE 


Defines serial receive as 9-bit word. 
Defines baud rate=1/((N+1) * .2794 microsec.) 


w A Sprite x pointer (high 3 bits) 

w A Sprite x pointer (low 15 bits) 

This pair of registers contains the 18-bit address 

of sprite x (x=0,1,2,3,4,5,6,7) DMA data. These address 
registers must be initialized by the processor or Copper 
every vertical blank time. 


W AD Sprite x vert-horiz start position data 

W AD Sprite x vert stop position and control data 
These two registers work together as position, size and 
feature sprite-control registers. They are usually loaded 
by the sprite DMA channel during horizontal blank; 

however, they may be loaded by either processor at any time. 


15-08 SV7-Svo st vertical value. Hon p1t(sva) is 
in SPRxCTL register be 
07-00 SHB-SH1 Start horizontal miä ov b1t (SH0) is 
in SPRxCTL register below 


SPRxCTL register (writing this address disables sprite 
horizontal comparator circuit): 
BI SYM 


FUNCTION 
15-08 EV7-EV0 End (stop) vertical value 10 8 bits 


07 ATT Sprite attach control bit (odd sprites) 
06-04 x Not used 

02 sv8 Start vertical value high bit 

01 EV8 End (stop) vertical value high bit 

00 SHO Start horizontal value low bit 

w D Sprite x image data register A 


W D Sprite x image data register B 

These registers buffer the sprite image data. They are 
usually loaded by the sprite DMA channel but may be 
loaded by either processor at any time. When a 
horizontal comparison occurs, the buffers are dumped 
into shift registers and serially outputted to the 
display, MSB first on the left. 

NOTE: Writing to the A buffer enables (arms) the sprite. 
Writing to the SPRxCIL register disables the sprite. 

1f enabled, data in the A and B buffers will be outputted 
vhenever the beam counter eguals the sprite horizontal 
position value in the SPRxPOS register. 


004 
02A 


006 
02c 


D Strobe for horizontal sync with VB 
and EOU 

D Strobe foi horizontal sync with VB 
(vertical blank) 

DP Strobe for horizontal sync 

D Strobe for identification of long 
horizontal line 


first refresh time slot. The fourth strobe shoin 
above is used during the second refresh time slot of 

other line to identify lines with long counts 
(228). There are four refresh time slots, and any 
not used for strobes will leave a null (FF) address 
on the destination address bus. 


R A Read vertical most significant bit 

(and frame flop) 
W A Write vertical most significant bit 

(and frame flop) 
BIT 15,14,13,12,11,10,09,08,07,06,05,04,03,02,01,00 
USE LOB=- "<< =-<;<e au <a majan an an 00 mo 50:50 VO 
LOF=Long frame (auto toggle control bit in BPLCOON0) 
R A Read vertical and horizontal position of 

beam or lightpen 

w A Write vertical and horizontal position 


of beam or lightpen 
BIT 15.14.13,12,11,10,09,08,07,06,05,04,03,02,01,00 
USE V7 V6 VS V4 V3 V2 V1 V0,H8 H7 H6 HS H4 H3 H2 H1 
RESOLUTION = 1/160 of screen width (280 ns) 
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Include-tiedostot 
Liite D 


Include-tiedostot 


A monipuolisen käyttöjärjestelmän käytössä on tarpeen tuntea useita structurei- 
ta ja vakioita. Ohjelmoijien työtä helpottaakseen Commodore levittää vakio- ja 
structuremäärityksiä levykkeellä ryhmiteltynä useisiin include-tiedostoihin. Kun nämä tie- 
dostot liitetään käännettäessä omien ohjelmien alkuun, tuntee assemblerkääntäjä auto- 
maattisesti kaikki vakiot. Näin ohjelmoija välttyy numerotiedon käsittelyltä ja muistami- 
selta. Esimerkiksi luotaessa Open-rutiinilla uutta tiedostoa on rutiinille annettava tiedos- 
ton tyypiksi 1006. Include-tiedostoa dos.i käytettäessä luvun 1006 tilalle voidaan kirjoit- 
taa huomattavasti havainnollisempi symboli "MODE NEWFILE". Samoin jo olemassa 
olevan tiedoston avaamiseen voidaan käyttää tunnusta "MODE OLDFILE" luvun 1005 
asemesta. 

Koska include-tiedostot vievät erittäin paljon tilaa, niitä ei ole listattu kirjaan. Sen si- 
jaan ne löytyvät mukana toimitettavan levykkeen Include-hakemistosta. Tiedostot on siir- 
retty levykkeelle sellaisinaan. Osa tiedostoista on ryhmitelty kirjastoittain alihakemistoi- 
hin, osa on suoraan Include-hakemistossa. Mukana on myös JMPLibs.i-niminen tiedosto, 
jossa on määritelty joitakin esimerkkiohjelmissa käytettyjä makroja, kuten openlib, lib ja 
closlib. 

Include-tiedostoja ja erityisesti niiden kommentteja tutkimalla voi oppia paljon Ami- 
gan ja sen käyttöjärjestelmän toiminnasta. Siksi voi olla hyödyllistä listata kaikki include- 
tiedosto paperille, josta niitä on tarvittaessa helpompi lukea. 
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Esimerkkiohjelmat 
Liite E 


Esimerkkiohjelmat 


S euraavassa on listattu levykkeellä olevia esimerkkiohjelmia. Levyke sisältää sekä läh- 
dekieliset että ajettavat versiot näistä sekä muutamista muista ohjelmista. 

Esimerkkejä ja makroja tutkimalla käytännön ohjelmointi selviää paremmin kuin pelk- 
kää teoriaa lukemalla. Sitten ei muuta kuin kokeilemaan. 
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Esimerkkiohjelmat 


$$ Grafiikkakirjastoesimerkki 
- Created 880721 by TM & JM — 
Tama rutiini esittelee useiden 


Ohjelman tutkimista helpottaa, 
esittelevaa osaa. 


Bugs: None known. 


Edited: 


- 880722 by JM, TM 


PS KKT YLISTI PPL. 


- Kommentoitu, 


kää 


grafiikkakirjaston rutiinien kayttoa. 
jos seuraa kirjan grafiikkarutiineja 


Ohjelma on kaannettavissa sellaisenaan Metacomcon makroassemblerilla. 


lisatty ClipBlit, Text, PolyDraw 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKÄK 


* 


* Maaritellaan kutsuttavat kayttojarjestelmarutiinit: ie) 


* 


* 


Kk*KKKKKKKKKKKKKKKKKKKKKÄKKKKKKKÄKKKKKKKÄKKKKKKÄKKKÄKKKÄKKKKKKKÄKKKKKKÄKKKKKKKÄKKK 


xref LVOOpenLibrary 
xref ' LvVOCloseLibrary 
xref * LVODelay 
xref " LVO0OpenScreen 
xref * LVO00penWindow 
xref — LVOCloseScreen 
xref — LVOCloseWindow 
xref — LVOMove 
xref LVODraw 
xref ""LVOGelsFuncE 
xref ”LVOSetaAPen 
xref — LVOSetDrMd 
xref — LVOAllocMem 
xref LVOFreeMem 
xref * LVOF1l00d 
xref " LVOL0adRGB4 
xref * LVORectFill 
xref "LVOClipBlit 
xref — LVOText 
xref — LVOPolyDraw 
RasteriKoko egu ((320+15) /16*2) *200 


* PUSH-makro tallettaa prosessorin rekistereja pinoon. 


Makro on esitelty 


* kirjan makroja kasittelevassa kohdassa. 


* push <reg list | 


all> 


a6,-(sp) 


push macro 
ifc ENIN, 011” 
movem.1 d0-d7/a0- 
endc 
ifnc 'N1','/all' 
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movem.1 Y1,-(sp) 

endc 

endm 
x PULL-makro ottaa prosessorin rekisterien arvot pinosta. Makro on esitelty 
* kirjan makroja kasittelevassa kohdassa. 


pull macro * pull <reg list | all> 
ifc 1N1','all' 
movem.1 (sp)+,d0-d47/a0-a6 
endc 
ifnc 1N1/,'all' 
movem.1 (sp)+,1V1 
endc 
endm 


OPENLIB-makro avaa halutun kirjaston. Se voidaan korvata normaalilla 
koodilla: 
move.l 4,a6 


lea kirjaston nimi (pc),al 
moveg.1 fH0,d0 
jsr LVOOpenLibrary (a6) 


move.1 <d0,perusosoite 
Esimerkki: Avataan Intuition-kirjasto: 


move.1l 4,a6 


lea f$Intuition nimi (pc),al 
moveg.1 40,d0 
jsr LVOOpenLibrary (a6) 


move.1 <d0,IntuitionBase 


Ohjelman lopussa on maariteltava kirjaston nimi ja perusosoitteelle 
varattava tila: 


IntuitionBase dc.1 O 
Intuition nimi dc.b ”intuition.library',0 


HUOMAA: 
Kirjaston perusosoitteen on sijaittava PARILLISESSA osoitteessa! 
Muutoin move.1 ao. osoitteeseen/pois siita aiheuttaa gurun nro 3. 


* 4 2 26 2 H X X AA A A A * X 


openlib macro *LIB ID, CLEANUP openlib Dos, cleanup 
DVI set 1 

move.1 4,46 

lea N1Lib (pc) ,al1 

moveg.1 F0,d0 

jsr — LVOOpenLibrary (a6) 

move.l d0, VlBase 

ifnc E NZ IA 

beg 2 

endc 

endm 
* CLOSLIB-makro sulkee halutun kirjaston. Se voidaan korvata normaalilla 
* koodilla: 
* move.l 4,a6 
* move.l Pperusosoite(pc),al 
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jsr — LVOCloseLibrary (a6) 


* * * * »» 


olla nolla). 
closlib macro *LIB ID 


move.1 = V1Base(pc),al 


move.1 &al,d0 
beg cLIBVG 
move.1 4,236 


CLOSLIB-makro vastaa muuten yllaolevaa koodia, mutta se tarkistaa ennen 
kirjaston sulkemista, onko kirjasto todella avattu. Jos perusosoite on 
nolla, CLOSLIB ei sulje kirjastoa (minkaan kirjaston perusosoite ei voi 


closlib Dos 


jsr — LVOCloseLibrary (a6) 
cLIBVG clr.1 —VlBase 
endm 
* LIB-makro kutsuu haluttua kirjastorutiinia. Se voidaan korvata normaalilla 
* koodilla: 
* move.l Pperusosoite(pc),a6 
* jsr — LVOrutiini (a6) 
x 
* Jos kutsuttava kirjasto on Exec, LIB-makro lataa kirjaston perusosoitteen 
* suoraan osoitteesta 4. Muuten perusosoite luetaan kirjastoBase-paikasta, 
* esim. IntuitionBase. 
lib macro *LIB ID,ROUTINE lib Dos, Delay 
ifnc 1N1/,'/Exec' 
move.1 = |1Base(pc),a6 
endc 
ifc 1N1/,'Exec' 
move.1 $4,a36 
endc 
5sr —L1VO012 (26) 
endm 


KKKKKKKKKKKKKKKÄKKKKUKKKKÄKUÄKKÄKKKKKKKKKÄKÄKÄKKÄKÄKKÄKKKÄKKÄKKKKKKKKKÄKKKKKKÄKKKÄK 


*» * * » 


x 


KKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


PaaOhjelma openlib Dos,Loppu 


openlib Intuition, Loppu 


openlib Gfx,Loppu 


Aluksi avataan Dos, Intuition ja Graphics-kirjastot. 
Jos joku kirjastoista ei avaudu, poistutaan kohtaan Loppu. 
Tama on OPENLIB-makron ominaisuus. 


* 
* 
x 
x 
* 
* 


KKKKKKKKKKKKKKKKKKKKKKKÄKKKÄKÄKKKKKKÄKKKKKÄKKKÄKKKKÄKKKKKHKKKKKKKKKKKÄKKKÄKKÄKÄKKK 


x* * 
* Seuraavaksi avataan naytto, jonka resoluutio on 320 x 200 ja bitti- x 
* tasojen lukumaara 5 (varien maara 32). x 
* Jos naytto ei avautunut (muisti lopussa tms.), poistutaan kohtaan x 
* loppu. ja) 
x* * 
***KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKK 
AvaaNaytto lea NewScreen (pc) ,a0 
lib Intuition, OpenScreen 


move.l <d0,MinunNaytto 


beg Loppu 


197 


Esimerkkiohjelmat 


KÄKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKÄKKKÄKKKKKÄKKKÄKKKKKKÄKÄKKKKKKKKKKKKKKKKKKKÄKKKKK 


* Sitten avataan uuteen nayttoon ikkuna. Ikkunan NewWindow-structureen * 
* kirjoitetaan asken avatun nayton Screen-structuren osoitin, jotta x 
* kayttojarjestelma tietaa, mihin nayttoon ikkuna halutaan. x 
* Jos ikkuna ei avautunut (muisti lopussa tms.), poistutaan kohtaan x 
* loppu. N 
* * 
KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKÄKKKKKKKKKÄKKKKKKKKKKÄKKKKKKKKÄKKKKKÄKKKÄKK 
AvaalIkkuna move.1 MinunNaytto(pc) , NaytonOsoite 

lea NewWindow (pc) ,a0 

lib Intuition, OpenWindow 

move.l]l <d0,MinunIkkuna 

beg Loppu 


KkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKÄKKKKKKKÄKKKKÄKKKKK 


* 
Nyt selvitetaan ikkunaan liittyvan RastPort-structuren osoite piirto- * 
rutiineja varten. Alempana selvitetaan ViewPort-structuren osoite. * 
Osoitteet talletetaan RastPort- ja ViewPort-paikkoihin, jotka on * 
* 
* 
* 
* 


* * * * * »* 


maaritelty ohjelman lopussa. HUOMAA: Kaikkien LONG-tyyppisten 


(32-bittisten) lukujen on sijaittava PARIILISISSA osoitteissa!!! 
* 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKÄKKKÄ 


OtaRastPort move.1 MinunIkkuna (pc) ,a0 
move.1l 50(a0),RastPort 
OtaViewPort move.1 MinunNaytto(pc),a0 


add.1 444,20 


move.1 &a0,ViewPort 
KKKKKKKKKKKKKKÄKKKKKKKKKKKÄKKKKÄKKÄKKKKKÄKKKKKKKKKKKÄKKKKKKÄKKKÄKKKÄKÄKKKKKÄKKKKÄ 


* * 
* Nyt varataan muistia valiaikaiselle bittikartalle, jota Flood-rutiini * 
* tarvitsee. Muistia varataan Exec-kirjaston AllocMem-rutiinilla. * 
* Varattavan muistin koko on laskettu ohjelmalistauksen alussa. * 
* Varattavan muistin on sijaittava CHIP-RAMissa, jotta blitter voisi * 
* kayttaa sita. Jos muistia ei saatu, poistutaan kohtaan loppu. * 
* Kun muisti on varattu, siirretaan TmpRas-structuren osoite RastPort- * 
* structuren ao. kohtaan, jotta kayttojarjestelma tietaisi muistialueen * 
* sijainnin. x 
* * 
KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKÄKKKKÄKKÄKKKKKKKKÄKKKKKKKÄKÄKKKKÄKKÄKKKHÄKKKKK 
VaraaTmpRas move.1l jfRasteriKoko,d0 ; varattavan muistin maara 

move.1l 4d0,TmpRas+4 ; kerrotaan se myös 
kayttikselle 

moveg.1 H2,d1 ; muistin tyyppi: CHIP RAM 

1lib Exec, AllocMem 

move.1 4d0,TmpRas ; talletetaan varatun muistin 
alkuosoite 

beg Loppu 
AsetaTmpRas move.1l RastPort(pc),a0 ; kerrotaan RastPortille, 

move.1 fTmpRas,12(a0) ; missa muisti on 
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KKKKKKKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKÄKKKKKKKKÄKÄKKKKK 


x *x 
* Seuraavaksi asetetaan kaikki nayton 32 varia LoadRGB4-rutiinilla. x 
* * 


KK KI KK TKTT TKTT TOTTA TTKK KTETKTKTKTKTKTTKTKTETKTKTTA TKTT TTETK KTK TKTKETKTKKKKKAKKAKAÄKAKÄKKKAÄKKÄKA KKK 
AsetaVarit move.1 ViewPort(pc),a0 mihin varit asetetaan 
move.1 432,40 varien lukumaara 
lea VariKartta(pc),al varitaulukon osoite 
lib Gfx,LoadRGB4 VARIA! 


KKKKKKKKKKKKKKKKKKKKKKKKKKKUÄKKKKKKKKKKKKKKÄKKKKKKKÄÄKKÄKKKÄKKKKÄKKKKKÄKKKKÄKAKK 


RYIKTIKTISN 


* 
Ja sitten aloitetaan piirtely. Aluksi piirretaan 16 erivarista x 
viivaa kayttaen Move- ja Draw-rutiineja. Viivan vari asetetaan x 
SetAPen-rutiinilla. HUOMAA: al:een on ladattava aina uudestaan x 
bittikartan maarittelevan RastPort-structuren osoite, koska kirjasto- * 
rutiinit saattavat sotkea rekisterien d0,d1,a0 ja al arvot. Samasta * 
syysta silmukkalaskurina kaytetaan rekisteria d7. x 
Lue kaskyja esittelevasta kohdasta DBF-kaskyn selostus (DBcc)! x 

* 
* 


* * * *» * * * * 


* 
KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKÄKÄKKKKKKKKKKÄKKKKKKKKÄKKKK 


PiirraViivat moveg.1 $15,d7 ; laskuri 15...0 eli 16 
; viivaa! 
Silmukkal move.l RastPort(pc),al ; bittikartta, johon 
piirretaan 
moveg.1 16,d0 ; kaytetaan vareja 16...31 
add.1 d7,d0 ; lisataan viivan numero 
16:een 
1lib Gfx,SetAPen ; ja asetetaan tulos variksi 
move.l RastPort(pc),al ; bittikartta, johon 
piirretaan 
move.1 %4152,4d0 ; lasketaan viivan alkupiste 
add.1 d7,4d0 ; x-koordinaatti muuttuu 
move.1l %190,d1 ; y-koordinaatti on kiintea 
1lib Gfx,Move ; siirretaan kyna 
alkupisteeseem 
move.1 RastPort(pc),al ; bittikartta, johon 
piirretaan 
move.1 %167,4d0 ; lasketaan viivan loppupiste 
sub.1 d7,d0 ; x-koordinaatti muuttuu 
moveg.1 $10,d1 ; y-koordinaatti on kiintea 
lib Gfx,Draw ; PIIRRA! 
dbf d7,Silmukkal ; toistetaan, kunnes kaikki 


; viivat on piirretty. 
KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KK KÄ AK KA KKKA AKK KK KKKA KK KKKA KKKKKKKK KKKA KKAA 


Ja sittenpa piirretaan ympyra. Piirtoon kaytetaan dokumentoimatonta 
funktiota GelsFuncE, joka piirtaa ellipsin pisteen (d0,d1) ymparille. 
x-sade on d2 ja y-sade 43. 


»” *» » 
* * * * * 


* 
KKKKKKKKUKKKKKKKKKKKKKKUKKKKKKEKKKKKAKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKÄKKKKKKÄKKÄ 


PiirraYmpyra move.1 RastPort(pc),al ; asetetaan piirtovari 
moveg.1 $5,4d0 ; (vari nro 5) 
lib Gfx, SetAPen 
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move.1 
move.1 
moveg.1 
moveg.1 
moveg.1 
lib 


RastPort (pc) ,al 
$160,4d0 

$100,d1 

$100,42 

480,43 
Gfx,GelsFuncE 


; 


x-koordinaatti 
y-koordinaatti 
x-sade 

y- sade 
ELLIPSI!!! 


X kkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKÄKKKKKÄKKKKKKK 


x 


* Nyt on aika tayttaa ellipsin puolikkaat eri vareilla. 
* kaytetaan Flood-rutiinia, 


x 


joka on tosin melko hidas. 


x 


Tayttamiseen x 


* 
x 


*k*kKKKKKKKKKKKKKKKKKKKKKKKKUÄKKUKKKKKKKKKUKKKKKKKKKKKKUKKKKKKKKUKKAKÄKKKKKKKKKKK 


TaytaAlueet move.1 
moveg.1 
lib 
move.1 
move.1 

koordinaatti 
moveg.1 

koordinaatti 
moveg.1 
lib 
move.1 

10 
moveg.1 
lib 
move.1 
move.1 

koordinaatti 
moveg.1 

koordinaatti 
moveg.1 
lib 


RastPort (pc) ,al 
13,40 

Gfx, SetAPen 
RastPort (pc) ,al 
$180,4d0 


$100,d1 


$1,d2 
Gfx,Flood 
RastPort (pc) ,al 


410,40 

Gfx, SetAPen 
RastPort (pc) ,al 
$140,40 


$100,d1 


11,42 
Gfx,Flood 


? 


r 


, 


valitaan vari nro 
bittikartta, jota 
aloituspisteen x- 
aloituspisteen y- 
moodi 


TAYTA!!! 
ja sitten otetaan 


bittikartta, jota 
aloituspisteen x- 


aloituspisteen y- 


moodi 
TAYTA!!! 


3, 


taytetaan 


vari nro 


taytetaan 


K*KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKÄKKKKUKKKKKKKKKKKKKKKKKKKKK 


* * * »* 


x 


KAKKKKKKKKKAKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKUÄKKKÄKKKÄKKAÄKKKKKKKKKKKKKÄKKKKÄKKKÄ 


PiirraNeliot moveg.1 

Silmukka2 move.1 
move.1 
1lib 
move.1 
and.b 


Piirretaan 31 neliota RectFill-rutiinilla. 
nelion kulmien koordinaatit ja asetetaan piirtovariksi nelion numero. 
Koska numero on 31...0, kaikki varit tulevat kayttoon. 


131,47 
d7,4d0 
RastPort (pc) ,al 
Gfx, SetaAPen 
47,40 

3,40 

$4,40 
414,40 
d7,d1 
128,41 
$2,41 

t4,4d1 
$30,4d1 


Ennen rutiinia lasketaan 


[ 


? 


32 neliota 


* 
* 
* 
* 
* 
* 


asetetaan nelion vari 


vasen ylakulma: x- 


vasen ylakulma: y- 


koord. 


koord. 
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move.1l d0,42 

add.w $15,42 

move.1l 4d1,d3 

add.w 415,43 

move.l RastPort(pc),al 
1lib Gfx,RectFill 
dbf d7,Silmukka2 


7 
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oikea alakulma: x-koord. 
oikea alakulma: y-koord. 
mihin piirretaan 


NELIOI!!! 
toista, kunnes 32 neliota 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKÄKKÄKKÄÄKKKÄKKKKKKKÄKKKK 


x 


*x 


* Sitten piirretaan nelioiden valille (ymparille) ristikko. * 
* Homma hoituu pienella laskemisella seka Move- ja Draw-rutiineilla. x 


x 


* 


K*KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


PiirraRistikko 


Silmukka3 


Silmukka4 


moveg.1 4,47 
move.l RastPort(pc),al 
moveg.1 %7,d0 


lib Gfx,SetAPen 
move.l 4d7,4d0 

asl.w 44,40 

add.w 114,40 

moveg.1 f$30,dl 

move.1l d0,d2 

move.l RastPort(pc),al 
lib Gfx,Move 

move.l d2,d0 

move.1 %158,dl 

move.l RastPort(pc),al 
lib Gfx,Draw 

dbf d7,Silmukka3 


moveg.1 %8,4d7 
moveg.1 $14,d0 


move.1l 4d7,dl 

asl.w $4,41 

add.w 430,d1 

move.1l <dl1,d2 

move.l RastPort(pc),al 
lib Gfx,Move 
moveg.1 78,40 

move.1l d2,d1 

move.1l RastPort(pc),al 
1lib Gfx,Draw 

dbf d7,Silmukka4 


[ 


7 


[A 


7 


tarvitaan 5 pystyviivaa 
kaytetaan varia 7 


lasketaan viivan alkupiste 


loppupisteen x-koord. 
kyna alkupisteeseen 


piirretaan yksi viiva 
toistetaan, kunnes 5 viivaa 
sitten viela 9 vaakaviivaa 
jalleen alkupisteen koord. 


ja loppu-x 


kyna alkupisteeseen 


piirretaan viiva 
ja toistetaan, kunnes 9. 


Kk*kKkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* 


* Tulostetaan seuraavaksi vahan tekstia. 


* 


* 
* 
* 


KKKKKUKKKUKKKÄKKKKKKKKKKKKÄKKKKKKKKKKKÄKKÄKKKKÄKKKKKKKÄKKÄKKKKKKKKKKKKKKKKKKK 


move.l RastPort(pc),al 
moveg.1 %4,40 

lib Gfx,SetAPen 
move.l RastPort(pc),al 
moveg.1 %0,4d0 

lib Gfx,SetDrMd 


; 


[ 


kaytetaan varia 4 


kaytetaan moodia JAMI 
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moveg.1 490,40 ; x-koordinaatti 
moveg.1 460,41 ; y-koordinaatti 
move.l RastPort(pc),al 

lib Gfx,Move ; kyna tekstin alkuun! 
lea teksti (pc) ,a0 ; tekstin osoite 
moveg.1 %$18,d0 ; tekstin pituus 
move.l RastPort(pc),al 

lib Gfx,Text ; TULOSTA! 


KAKKKKKKKKKKKKKKKKKKKKKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKA 


* 


* 


* Piirretaan viela kehys tekstin ymparille PolyDraw-rutiinilla. ji 


* 


x 


KKKKKKKKKKKKUEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKRÄKKKKKKKAKKKKKÄ 


PiirraKuvio move.1 RastPort(pc),al 
moveg.1 $1,4d0 
lib Gfx, SetAPen 
move.l RastPort(pc),al 
C1=.1 d0 
clr.1 dl 
move.w KuvionViivat(pc),d0 
move.w KuvionViivat+2(pc),dl 
lib Gfx,Move 
lea KuvionViivat (pc) ,a0 
move.l RastPort(pc),al 
moveg.1 11,40 
lib Gfx,PolyDraw 


KKKKKKKKKKKKKKKKKKKKKKKKKKKUKKKUKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


x *x 
* Sitten kokeillaan blitterin tehoa alueen kopioinnissa. x 
* Kopioidaan asken piirretty nelio nayton oikeaan alakulmaan ClipBlit- * 
* rutiinilla. Tarvitsee vain asettaa alue, koko, kohde, minterm ja * 
* RastPort seka kutsua rutiinia. x 
* x 
kA*KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 
KopioiLoota moveg.1 $14,4d0 ; lahde-x 

moveg.1 $30,d1 ; lahde-y 

move.1 f%242,42 ; kohde-x 

moveg.1 f60,4d3 ; kohde-y 

moveg.1 $65,d4 ; x-koko 

move.1 %4%129,45 ; y-koko 

move.1 %4$c0,4d6 ; minterm 

move.1 RastPort(pc),a0 ; lahde-RastPort-structuren osoite 

move.1 RastPort(pc),al ; kohde-RastPort-structuren osoite 

1ib Gfx,ClipBlit 


KÄAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKÄKKKKKÄKKKKKKKKK 
* * 
* Nyt on aika hengahtaa vahan ja antaa kayttajan tutkia aikaansaannoksia* 


* Muodostetaan 15 sekunnin viive. 
* 


* 
* 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKÄKKKKKÄKÄKÄKKKKÄKKKKKKKÄKÄÄKÄKÄKKÄKKKKKKÄKKÄ 
Odotal5Sek move.1 %415*50,dl 
1lib Dos,Delay 
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*Xkk*KKKKKKKKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* x 
* Tahan tullaan, jos jokin kirjastoista, ikkuna tai naytto ei auennut. * 
* Kaikki varatut ja avatut jutut vapautetaan ja suljetaan ennen x 
* ohjelmasta poistumista. x 
x x 
*KKKKKKKKKKKKKÄKKKKKKKKÄKKKKKUKUKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 
Loppu tst.1 MinunIkkuna ; onko ikkuna auki? 

beg Loppul ; jos ei, ei suljeta sita! 
SuljeIkkuna move.1 MinunIkkuna(pc),a0 

lib Intuition, CloseWindow 
Loppul tst.1 MinunNaytto ; onko naytto auki? 

beg Loppu2 ; jos ei, ei suljeta sita! 
SuljeNaytto move.l MinunNaytto(pc),a0 

lib Intuition, CloseScreen 
Loppu2 tst.1 TmpRas ; onko muistia varattu? 

beg Loppu3 ; jos ei, ei vapauteta sita! 


VapautaTmpRas move.1 TmpRas(pc),al 
move.1 TmpRas+4(pc),d0 


lib Exec, FreeMem 
Loppu3 closlib Intuition ; suljetaan kirjastot. 
closlib Gfx ; eloslib testaa 
automaattisesti, 
closlib Dos ; oliko kirjasto auki vai ei. 
clr.1 d0 7; tieto DOSsille: ei 
virhetta! 
rts ; ohjelma LOPPUUUUU... 
TmpRas dc.1 (0) ; tilaa TmpRas-structurelle 
de.1 [0) 
*kkkkKKKKKKKKKKKKKKKKKKEÄKKUKKKKKAKKKKKKUKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKÄKKKKK 
* * 
* Nayton maaritteleva NewScreen-structure: x 
* x 
KKKKKKKKKKKKKKÄKKKKKKKKKKÄKKKÄKKKKKKKKÄKKKKKKKKKKKÄKKÄKKKÄKÄKKKKKKKKKKKKKKKKÄKKÄK 
NewScreen de.w 0,0,320,230 koordinaatit ja koko 
dc.w 5 bittitasojen lukumaara 
dc.b 4,11 otsikkopalkin varit 
de.w [0] resoluutio 


dC.w $000f tyyppi = CUSTOMSCREEN 
dc.1 TextAttr kaytettava fontti 
dc.1 Otsikko otsikkopalkin teksti 


dc.1 0,0 ; ei nappuloita eika CustomBitMap:ia 
KkkKKKKKKKKÄKKKKKKKKKKKKÄKKKKKKKKKAÄKKKKKKKKKKKKKKKKKKKKKKÄKKKKÄKKÄKKÄKÄKKÄKKÄKKKK 


* 


Ikkunan maaritteleva NewWindow-structure: x 
Screen-structure-osoittimen ohjelma kirjoittaa itse sille varattuun x 
paikkaan nayton avaamisen jalkeen. Osoitintahan ei tunneta ennen x 
* 
x 
*x 


» * * * »* 


nayton avaamista!!! 
* 


KKKKKKKKKKKKKKKKKUKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKKK 


NewWindow dc.w 0,20,320,200 ? koordinaatit ja koko 
dc.b 4,11 ; otsikkopalkin varit 
dc.1 0,0 ; ei IDCMP, ei lippuja 
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* 


dc.1 0,0 ; ei nappuloita, ei merkkia 

dc.1 IkkunanOtsikko ; otsikkopalkin teksti 
NaytonOsoite dc.1 (0) ; osoitin Screen-structureen 

dc.1 [e] ; ei osoitinta BitMap-structureen 

dc.w 0,0,320,200 ; minimi/maksimikoko 

dc.w $000f ; tyyppi: CUSTOMSCREEN 
KkkkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKKK 
x x 
* Fontin maaritteleva TextAttr-structure: x 
*x * 
KEKKAKKKKKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKK 
TextAttr dc.1 FontinNimi ; fontin nimi 

dc.w 8 ; fontin korkeus 

dc.b 10] ; ei lippuja 

dc.b (0) 
FontinNimi dc.b 'topaz.font' ,0 ; itse fontin nimi 

ds.1 0) ; tasataan osoite 4:lla jaolliseksi! 
IkkunanOotsikko dc.b / Ikkunan OtsikkoPalkki',0 

ds.1 [0] ; tasataan osoite 4:lla jaolliseksi! 
Otsikko dc.b 'OtsikkoPalkki' ,0 

ds.1 [0] ; tasataan osoite 4:lla jaolliseksi! 
teksti dc.b "Yksi rivi tekstia!” 

ds.1 [e] ; tasataan osoite 4:lla jaolliseksi! 
KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 
* * 
* HUOMAA: * 
x x 
* Merkkijonojen maarittelemisen jalkeen osoite on tasattava x 
* parilliseksi esim. ds.1 0 -komennolla, jotta seuraavat sanat (dc.w) * 
* ja pitkat sanat (dc.1) tulisivat varmasti parillisiin osoitteisiin. x 
* Jos merkkijonon pituus loppunollineen on parillinen, tama ei ole * 
* tarpeen (edellyttaen tietysti, etta merkkijono alkaa parillisesta x 
* osoitteesta). x 

* 
* 


KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKÄKÄKKKKÄKKKKKKKKKKÄÄKÄKKÄKKKÄ 


KuvionViivat dc. 
de. 
VariKartta dc. 
de. 
dc. 
de. 
dc. 
dc. 
dc. 
dc. 


TETTKEKEETÄ 


85,52,239,52,239,62,85,62,85,52 
88,52,88,49,236,49,236,65,88,65,88,49 
$000,$00£f, $0f0,$0ff 
$£00,$f0f,$f£f0,$fff 

$800,$80f, $8f0,$8ff 
S£88,$f8f, $S£FB, 5888 
$000,$011,$122,$133 
$244,$255,$366,$377 

$488, $499, $5aa, $5bb 

$6cc, $6dd, $7ee,$7ff 
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*kk*kkKKKKKKKKKKÄKKKKUKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKK 


* * 
* Kun dc.1 (dc.b, dc.w) varaa muistia, se sijoittaa osoitteeseen annetun* 
* luvun. Siten esimerkiksi dc.w 4 sijoittaa varaamaansa 16-bittiseen x 
* tilaan luvun 4. Koska allaolevat osoittimet varataan juuri talla x 
* komennolla, osoittimien alkuperaiseksi arvoksi voidaan asettaa nolla. * 
* Ohjelmassa tata kaytetaan hyvaksi siten, etta esimerkiksi nayton * 
* auettua osoittimen arvo muutetaan nollasta eroavaksi. Ohjelman x 
* lopussa voidaan tarkistaa, oliko naytto avattu tutkimalla osoittimen * 
* arvoa. Jos arvo oli nolla, se ei ollut muuttunut eli naytto ei ollut * 
* auennut. Samaa hyodynnetaan kirjastojen perusosoitteissa yms. x 
*x * 
* Komennot ds.b, ds.w ja ds.1l varaavat vain muistia, mutta eivat alusta * 
* sen sisaltoa tiettyyn arvoon. Esimerkiksi ds.b 40 varaa 40 tavua, x 
* ds.1 25 varaa 25 pitkaa sanaa. Luku siis ilmoittaakin varattavan x 
* alueen koon, ei yhden paikan sisaltoa, kuten dc-komennoissa. x 
* 
x * 
kai.f.3.3 3.3.3 .3 RUK KKKKIKITKIKIKIKIKIKTITIIITIIIKEITTITKIEITITITIIITITTITTITIIITTTITIITTTTITTITITTTTI 
MinunIkkuna dc.1 (0) ; tila Window-structuren osoitteelle 
MinunNaytto dc.1 (0) ; tila Screen-structuren osoitteelle 
RastPort dc.1 [0] ; tila RastPort-structuren 
osoitteelle 
ViewPort dc.1 [0] ; tila ViewPort-structuren 
osoitteelle 
= GfxLib dc.b ' graphics.library' ,0 ; kirjastojen nimet 
—IntuitionLib dc.b 'intuition.library',0 
— DosLib dc.b ' dos.library',0 

ds.1 [0] ; tasataan osoite 4:lla jaolliseksi! 
= GfxBase dc.1 (0) ; grafiikkakirjaston perusosoite 
—IntuitionBase dc.1 [0] ; intuition-kirjaston perusosoite 
— DosBase dc.1 [0] ; dos-kirjaston perusosoite 

end ; LOPPU! 
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HH DOS-kirjastoesimerkki fff 


- Created 880723 by JM - 


Tama rutiini esittelee useiden DOS-kirjaston rutiinien kayttoa. 
Ohjelman tutkimista helpottaa, jos seuraa kirjan DOS-rutiineja 
esittelevaa osaa. 


Ohjelma on kaannettavissa sellaisenaan Metacomcon makroassemblerilla. 
Ohjelmassa ei ole kaytetty makroja. Myos kayttojarjestelmarutiinien 
kutsuoffsetit on maaritelty itse ohjelmassa, joten kaantamisen pitaisi 
onnistua myös Seka-assemblerilla. 


Rutiinille annetaan tiedoston nimi. Rutiini tulostaa tiedoston ruutuun 
kuten TYPE. Optiot eivat kuitenkaan toimi. 

Esimerkki: 

ex2 ex2.asm 

tulostaa ohjelman oman lahdekoodin CLI-ikkunaan. 


Bugs: Doesn't obey CTRLI + C. 


Edited: 


- 880723 by JM - Kommentoitu. 


KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKÄKKÄKKÄKKKKKKKKKKKK 
* 
Maaritellaan kutsuttavien rutiinien offsetit: x 
* 
KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* Exec: 

OpenLibrary egu -$228 
Closelibrary egu -$19e 
AllocMem egu -$c6 
FreeMem egu -$d2 
* Dos: 

Output egu -$3c 
Open egu -$le 
Close egu -$24 
Read egu -$2a 
Write egu -$30 
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TAVUJA egu 80 ; varattavan puskurin koko 


KKKKKKKKKKKKKKÄKKÄKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


x * 
* Kun DOS kaynnistaa meidan ohjelmamme, a0 sisaltaa komentorivin alku- * 
* osoitteen ja d0 sen pituuden mukaanlukien rivinvaihdon. x 
* Koska tama ohjelma tarvitsee tietaa tulostettavan tiedoston nimen, x 
* tallettaa se alussa a0:n ja dO:n arvot. Se myös nollaa yhden tavun ie 
* clr.b -1(a0,4d0.1) -kaskylla. Tama korvaa komentorivin lopussa olevan * 
* rivinsiirron nollatavulla, joka on tarpeen Open-rutiinille (tiedoston * 
* nimen on loputtava nollatavuun). x 
x * 
x x 


KKKKKKKKKKKKKKKKÄKKKKKKKKKKÄKKKKKÄKKKKKKKKKKKKKKÄKKKÄKKKKKKKKKKKKKKKKKKKKKK 


TiedotTalteen move.1l 4d0,pituus ; komentorivin pituus 
move.l 2a0,0soite ; komentorivin alkuosoite 
clr.b -1(a0,40.1) ; lisataan rivin loppuun 

nolla 


K KKKKKKKKKKKKKEKKKKÄKÄKKKKKKK KKK KKKKKKKKKKÄ KKK KKKKKÄ KKK KK KKK KK KKKKKKKKKKKKÄ KK 


x k 
* Avataan Dos-kirjasto: x 
* * 


X kkkkkkkkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


AvaaKirjasto lea dosname (pc) ,al ; kirjaston nimi 
moveg.1 40,40 ; versiolla ei valia 
move.1l 4,a6 ; execbase 
jsr OpenLibrary (a6) 
move.1l 4d0,dosbase ; dos-perusosoite 
beg dos ei auki ; jos dos ei auennut, POIS! 


*kkkkKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* * 
*x Otetaan selville CLI-ikkunaan tulostusta varten tarvittava tiedosto. * 
* Kayttis on jo avannut sen meille, eika meidan myöskaan tarvitse sulkea* 
* sita ohjelman lopussa. x 
* Vastaava syottotiedosto, jonka avulla voidaan lukea nappaimistoa, * 
* saadaan selville Input()-rutiinilla. HUOMAA: ZLukiessasi nappaimistoa* 
* tietoa tulee Read-rutiinille vasta, kun painat RETURN. x 
x * 
kk*kkkkkKKKKKKKKKKKKKKKKKKKKUKKKKKKKKUKKKKKKKKKKKIKKKKKKKKKKKKKKKKKKKKKKKKKKKÄK 


move.l dosbase(pc),a6 
jsr Output (a6) 
move.l &d0,0utfile ; tulostustiedoston osoitin 
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KE IKITIIKIIITIIIIITKIIITITKIIITITIITIIIEITIITITITIITIIIKITITTIKTIKITTIKIKIKTKKIKTKIKTKTATAI 
* * 
* Tarkistetaan, antoiko kayttaja meille tiedoston nimen. Ellei, pusku- * 
* rissa on pelkka nolla (siis puskurin ensimmainen merkki on nollatavu) .* 
* * 
KIKKKKKKKKKKÄKKKKKKKKKKKKKKKKÄKKKKÄKKKKKKKKÄKÄKKKKKKÄKKKKÄKKKKÄKKÄKKÄKKÄKKÄKKKKÄKKÄKKK 


move.1 osoite(pc),a0 ; Testataan komentorivin 1. 
merkki 


tst.b (a0) 
bne AvaaTiedosto 


Jos se on nolla, tiedoston 
nimi puuttuu. 


KEIKI ITITKTITITIIITIIIIIIIIITIIIITITIIKIIIIKIIITIIITIKITTTIITTTIKIKIKKKIIKKIIKKKKKKTTIKKAII 
* * 


* Jos nimea ei ole, tulostetaan virheilmoitus (teksti ohjelman lopussa) .* 
x * 


KAEKKKKKKKKKKKKKKÄKKKKKKKKKKKKÄKKKKKKKKKKKKKKÄKKKKKKÄKKKKÄKKKKÄKKÄKKÄKKÄKÄKKKKÄKKÄKKK 


lea ei nimea(pc),a0 ; virhe: ei tiedoston nimea 
bsr print 
bra SuljeKirjasto ; poistutaan ohjelmasta 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKÄKKKKKKKKÄKKKKÄKKKKÄKKÄKKÄKKÄKKKKÄKKKKÄKKKKÄKKÄ 
* 


* Jos tiedoston nimi oli annettu, avataan tiedosto. Moodi on 1005 x 
* eli MODE OLDFILE eli yritetaan avata jo olemassa oleva tiedosto. x 
* MODE=1006 sen sijaan luo uuden tiedoston ja tuhoaa vanhan, jos sellai-* 
* nen oli olemassa. Sita ei kuitenkaan haluta tassa, eihan? x 
* x 
KkKKKKKKKKKKÄKKKKKKKÄKKKKKÄKKKÄKKKKÄKKKKKÄKKKKÄKKÄKÄKKKKÄKKKÄKKKÄKKKKKKKKKKKKKKKKK 


AvaaTiedosto move.1 osoite(pc),d1 ; tiedoston nimi 
move.1 %1005,42 ; tyyppi: OLDFILE 
jsr Open (236) ; a6 sisaltaa jo dosbasen 
move.1 4d0,infile ; syoöottotiedoston osoitin 
bne VaraaMuisti ; jos aukesi, OK. 
lea ei auennut(pc),a0 ; jos tiedosto ei auennut, 
bsr print a ; tulostetaan virheilmoitus. 
bra SuljeKirjasto ; jos tiedosto ei auennut, 
POIS! 


KÄKKKÄKKKKKKKKKÄKÄKÄKKÄKKÄKKÄKÄKÄKKÄÄKÄKÄKÄKKÄKKÄKKÄKÄKÄKKÄKKKKKÄKKKKÄKKÄÄKÄKKKÄKÄKKÄKK 
* * 
* Sitten varataan 80 tavua puskurimuistia, jotta tiedostoa ei tarvitsisi* 
* lukea merkki kerrallaan (mika on kuvottavan hidasta). Puskurin alku- * 
* osoite talletetaan paikkaan muisti. * 
* * 
KÄIKKKKKKÄKKKÄKÄKKÄKKKKKKKKÄKKKÄKKKKKÄKKKKKKÄKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKK 


208 


Esimerkkiohjelmat 


VaraaMuisti move.1 %fTAVUJA,d0 ; varattavan muistin koko 
move.1 %41,d1 ; tyyppi: PUBLIC 
move.1l 4,26 ; kirjasto: Exec 
jsr AllocMem (a6) 
move.1 4d0,muisti ; talletetaan muistin 
alkuosoite 
beg SuljeTiedosto ; jos muistia ei saatu, POIS! 


KKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKÄKKÄKÄKKKKÄKKKKKKÄKÄKKÄKKÄKKKKÄKKKKKKÄKÄKÄKKKKKKKÄ 


x 

* Nyt voidaan aloittaa tulostus. Ensin luetaan syottotiedostosta 

* (infile) puskurillinen merkkeja, sitten tulostetaan puskurin sisalto 
* CLI-ikkunaan Writella. Jos Read ei saanut puskuria tayteen, tiedosto 
* loppui kesken. Siten silmukasta voidaan poistua, kun luettujen 
x 
x 
x 
x 
x 


* * * * * »* 


merkkien maara on erisuuri kuin pyydettyjen. Koska joka kerralla 
tulostetaan vain sama maara merkkeja kuin Read sai luettua, ei haittaa* 
vaikka puskuri ei viimeisella kerralla tulisikaan tayteen. x 
x 
KAKIKKKKKKKKKÄKKKÄKKKÄKKKÄKKÄKKÄKÄKKKKKKÄKKKKÄKKÄKKÄKKÄKKKKKKKKÄKKKKKÄKKKKKKKKKKÄKKN 


Silmukka move. infile(pc),dl 
move. muisti (pc) ,d2 


1 syöttotiedosto 
1 
move.l 4TAVUJA,d3 
2 
1 
1 


puskurin alkuosoite 
puskurin pituus 


move. dosbase (pc) ,a6 dos-kirjasto 


NIITIT 


jsr Read (a6) luetaan puskuri tayteen 

move. d0,43 luettujen tavujen maara 

move. outfile(pc),dl tulostustiedosto 

Puskurin alkuosoite 

valmiina 

jsr Write (a6) ; tulostetaan puskurin 
sisalto 

cmp.1 FTAVUJA, d3 ; Oliko puskuri taysi? 

beg Silmukka ; Jos oli, jatketaan 


K*RKKKKKKKKKKÄKKKKKKKKÄKKKKKKKKÄKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKÄKKK 


* * 
* On aika vapauttaa varattu muisti. * 
* * 


KKRKKKKKKKKKAKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKÄKÄKKKKKKKKKKK 


VapautaMuisti move.1 %TAVUJA,dO ; vapautettavan muistin maara 
move.l muisti(pc),al ; vapautettavan muistin 
osoite 
move.1 4,26 
jsr FreeMen (26) ; vapauttaa muistin 
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K*KKKKKKKÄKKKKKKÄKKUKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKK 


x * 
* Sitten suljetaan syottotiedosto tä 
* * 


K*KKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKÄKKKK 


SuljeTiedosto move.1 infile(pc),dl 
move.1 dosbase(pc),a6 
jsr Close (a6) 


suljettava tiedosto 
dos-kirjasto! 
suljetaan syottotiedosto 


K*KKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKUKKKKKKKKKKKK 


* * 
* Suljetaan viela Dos-kirjasto. * 
x * 


KkKKKKKKKKKKKKKKKKKKKKKKKKKAKKKKAKKKAKÄKKKKKKKKKKAKKKKKKKKKKKKUKKKKAKKKKKKKKKKK 


SuljeKirjasto move.1 dosbase,al ; dos-perusosoite (dosbase) 
move.1 4,a6 ; exec-perusosoite 
jsr CloseLibrary (a6) ; suljetaan dos-kirjasto 
dos ei auki moveg.1 0,40 ; ei virhetta. 
rts 


K*kkkkkkkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKUÄKKKKKKKKKKKKKKKKKÄKKKKKKKKKÄKÄKKKKKKKA 


* 
* Sitten tarvitaan aliohjelma virheilmoitusten tulostamista varten. x 
* Aluksi aliohjelman laskee tulostettavien merkkien maaran.etsimalla x 
* merkkijonon loppunollaa. Nollan pituus eli yksi tavu vahennetaan, * 
* samoin puskurin alkuosoite. Talloin jaljelle jaa ainoastaan tulos- x 
* tettavien merkkien lukumaara. Se ilmoitetaan Writelle, samoin x 
* puskurin alkuosoite ja tulostustiedosto. Ja sitten vaan tulostetaan! * 
x * 
x * 


Ki*k*KKKKKKKKUKKKKKUKKKAKKKKKKKEKKKKKKKKKKKKKKKKKKKKEKKKKKKKKKKKKKKKKKKKKKÄKKKK 


print move.1 &a0,d2 ; tulostettavan alkuosoite 
d2:een 
etsi nolla tst.b (a0)+ ; onko tekstin loppu? 
K bne etsi nolla ; jos ei, jatka! 
subg.1 %1,a0 ; vahennetaan nolla 
sub.1 d2,a0 ; vahennetaan alkuosoite 
; Nyt aO0 on merkkijonon 
pituus 
move.1 4a0,43 ; pituus d3:een Writelle 
move.1 outfile(pc),dl ; tulostustiedosto dl:een 
move.1 dosbase(pc),a6 ; dos-perusosoite 
jsr Write(a6) ; tulostetaan teksti!! 
rts 
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**KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


*x x 
* Lopuksi maaritellaan tilaa tarvittaville muuttujille. x 
* * 


KKKKKKKKKKKKKKKKKKÄKKKKKKKKÄKKÄKKKÄKKKKÄKKKKKKKKÄKKKÄKKKKKÄKKKKÄKKÄKKÄKKKKKKKKKKKK 


pituus dc.1 [0] ; tila komentorivin pituudelle 

osoite dc.1 [0] ; tila komentorivin alkuosoitteelle 
muisti dc.1 (0) ; tila puskurimuistin osoitteelle 
dosbase dc.1 jo) ; tila dos-perusosoitteelle 

infile dc.1 je) ; tila syoöottotiedoston osoittimelle 
outfile dc.1 [0] ; tila tulostustiedoston osoittimelle 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKK 


* * 
* Ja ihan lopuksi viela dos-kirjaston nimi ja virheilmoitustekstit: * 
x * 


K*KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKUÄKKKKKKKKKKKKKKKKKÄKKKKÄKKKKKKKKKKKKKKKKKKK 


dosname dc.b ' dos.library' ,O 
ei auennut dc.b ” Tiedostoa ei 1',246,”ydy.' ,10,0 
ei nimea dc.b ' Tiedoston nimi puuttuu.',10,0 


KKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKÄKKKKKKKKKKKKÄKKKKKKÄKKKKKKKKKKKKKKKÄKKKKÄKKKKK 


* * 
* Eika sitten enaa muuta kuin... x 
* * 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKÄKÄKKKKKKKÄKKKKKKK 


end ; LOPPU! 
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aie m = 


$$ DigiClock by JM & TM v 1.41 4$$$ 

- Created 880612 by JM & TM - 

Program written for the 'C' Magazine. Segment drawing by TM. 
Code is not very beautiful but we wanted to keep it as short as 


possible. 


Bugs: None alive. 


Edited: 

- 880612 by JM,TM -> v0.50 - Works. 

- 880613 by JM -> vl.00 - Code compressed. 

- 880613 by JM -> vl.10 - Close button added; code compressed. 

- 880613 by JM,TM -> vl1.40 - Code still compressed. length was 952 
bytes but was then cut down to 816 bytes. 

- 880725 by JM -> vl.41 - IDCMP corrected. CLOSEWINDOW must be 


checked with CMP.L! 


KEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKÄKKÄKÄKKKKÄKKKKKKÄKKKKÄKKKKÄKKÄKKKKÄKKKKKKKKKKKKKK 


Ohjelmassa on kaytetty jonkin verran makroja. Kaikki tarvittavat 
kayttojarjestelman include-tiedostot on yhdistetty yhdeksi tiedostoksi, 
jonka nimi on intuition.i. 


Koodi on tyypillista lahdekoodia, jota ei ole kommentoitu erikoisen 
hyvin. Ohjelma on kuitenkin toiminnaltaan suhteellisen yksinkertainen, 
joten kaiken tarpeellisen pitaisi kylla selvita. 


Ohjelman ajettava koodi on julkaistu heksadumppauksena C=lehdessa. 
Koska ohjelma on pyritty pitamaan mahdollisimman lyhyena, se ei ole 
erikoisen hienoa koodia. 


xref LVOOpenLibrary 
xref * LVOCloseLibrary 
xref LVOAllocMem 
xref * LVOFreeMem 
xref —LVODisable 
xref —LVOEnable 
xref —LVOWait 

xref LVOGetMsg 
xref " LVOReplyMsg 
xref — LVOExecute 
xref — LVOOpen 
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LF 


Start 


xref 
xref 
xref 
xref 
xref 
xref 


xref 
xref 
xref 
xref 
xref 
xref 
xref 
xref 
xref 


xref 
xref 
xref 
xref 
xref 
xref 
xref 
xref 
xref 
xref 
xref 


include 
include 


BITDEF 
BITDEF 
BITDEF 
BITDEF, 
BITDEF 


egu 


push 

openlib 
openlib 
openlib 


lea 
1lib 
move.1 
beg 
move.1 
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 LVOClose 

— LVO0utput 

— LVORead 

— LVOWrite 
LVODelay 

"LVODateStamp 


— LVOMove 
—LVODraw 
LVOText 
— LvOSetaAPen 
LVOSetBPen 
" LVOSetDrMd 
"LVOSetRast 
LVOLOadRGB4 
— LVOVBeamPos 


LVOScreenToFront 
" LVOScreenToBack 
”LVOOpenScreen 
—LVOCloseScreen 
— LVO00penWindow 

LVOCloseWindow 
* LVOMoveScreen 
— LVOOpenFont 

LVOCloseFont 
* LVOOpenDiskFont 
—LVORectFill 


"JMPLibs.i" 
"intuition.i" 


MEM, PUBLIC,O 
MEM, CHIP,1 
MEM, FAST, 2 
MEM, CLEAR, 16 
MEM, LARGEST, 17 


10 
d2-d47/a2-a6 save regs 
Dos,cleanup dos open Dos library 


Gfx, cleanup gfx 
Intuition, cleanup int 


ClWindow (pc) ,a0 

Intuition, OpenWindow 

d0,d6 window ptr 
cleanup 

d0,a0 
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Colon 


Colon off 


Main 


Sleep 
WaitTicks 


move.1 


moveg.1 
move .1 
lib 

move.1 
moveg.1 
moveg.1 
move.1 
moveg.1 
flib 


moveg.1 
bchg.b 
beg 
addg.1 
move.1 
1lib 
move.1 
move.1 
moveg.1 
move.1 
addg.w 
moveg.1 
flib 


move.1 
move.1 
moveg.1 
moveg.1 
flib 


lea 
move.1 
lib 


move.1 
cmp.w 
beg 
move.w 
divu.w 
move.1 
moveg.1 
bsr 
swap 
move.1 
bsr 


moveg.1 
moveg.1 
1lib 
move.1 
move.1 


wd RPort(a0),a5 


42,40 

a5,al 

Gfx, SetAPen 
a5,al 

42,40 

$10,d1 
311,42 
477,43 
Gfx,RectFill 


12,40 

10, col col 
Colon off 
1,40" 
a5,a1 

Gfx, SetAPen 
a5,a1l 
$152,40 
430,d1 
d0,d2 

48,42 
434,43 
Gfx,RectFill 


a5,al 
$152,40 
$52,d1 
456,43 
Gfx,RectFill 


TimeBuf (pc) ,a0 
a0,d1 
Dos,DateStamp 


TimeBuf+4 (pc) , d2 
oldtime (pc) ,d2 
Sleep 
d2,0ldtime 
460,42 

d2,d3 

1-68, 40 

draw2 

d3 

a3,d2 

draw2 


24,44 

$1,d1 

Dos,Delay 

d6,a0 

wd UserPort (a0),a4 


rastport 


Fill background 


Toggle colon color 


Set color black/orange 


Draw colon (upper dot) 


Draw colon (lower dot) 


read time 


convert to hours/minutes 
save minutes 
reset x-coord 


Sleep for a while 


windowptr 
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GetMsgLoop 


Colonize 


cleanup 


clean90 

cleanup int 
cleanup gfx 
cleanup dos 


draw2 


drawdigit 


drawdigitl 


drawsegment1 


move. 
lib 
move. 
beg 
move. 
move. 
lib 
move. 
£f1lib 
tst.1 
bne 
cmp.1 
beg 
dbf 
bra 


H HR H H 


move.1 
beg 
move .1 
1lib 


clos1l 
clos1l 
clos1l 
pull 
rts 


and.1 
divu.w 
move .b 
add.w 
bsr 
swap 
move .b 
add.w 


push 
move.1 
lea 

ext .w 
move.b 
1s1.b 
moveg.1 
lea 
moveg.1 
1s1.b 
bcec 
moveg.1 
move.1 
lib 
moveg.1 


a4,a0 
Exec,GetMsg 
d0,42 

Colonize 

d2,al1 

im Class(al),4d3 
Exec, ReplyMsg 
a4,a0 

Exec, GetMsg 

d0 

GetMsgLoop 
K$CLOSEWINDOW,d3 
cleanup 
d4,WaitTicks 
Colon 


46,40 
clean90 
d0,a0 
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port* 

Check if a message received 
message* 

No msg received 
IntuiMessage * 

Class 


port 


Intuition, CloseWindow 


Intuition 
Gfx 

Dos 
d2-47/a2-a6 


$SEEE£F, 42 
410,42 
d2,d1 
1488, d0 
drawdigit 
d2 


d2,d1 
168, d0 


all 
d0,d2 


digitdata (pc) ,a0 


d1 
0(a0,d1.w),d3 
11,43 

*6,44 

segment (pc) ,a2 
12,40 

41,43 
drawsegmentl 
$3,4a0 

a5,al 

Gfx, SetAPen 
43,47 


10 hours 
xcoord 


get hours 
inc x 
save registers 


x-coordinate of the digit 


segment data 
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drawsegment2 


drawlinel 


segment 


digitdata 


ClWindow 
col col 
TimeBuf 


moveg.1 
move.1 


$0,40 

d40,d1 

(a2)+,40 
drawlinel 
(a2)+,d1 

d2,40 

a5,al 

Gfx,Move 

10,40 

40,41 

(a2)+,d0 
(a2)+,d1 

42,40 

a5,al 

Gfx,Draw 

d7, drawsegment2 
d4,drawdigitl 
all restore registers 


; segment coordinates 
2,20,45,20,3,21,44,21,4,22,43,22,-1 
; segment A 


47,22,47,41,46,23,46,40,45,24,45,39,44,25,44,38 


; segment B 


47,45,47,65,46,46,46,64,45,47,45,63,44,48,44, 62 


; segment C 
2,67,45,67,3,66,44,66,4,65,43,65,-1 
segment D 


0,45,0,65,1,46,1,64,2,47,2,63,3,48,3,62 


; segment E 
0,22,0,41,1,23,1,40,2,24,2,39,3,25,3,38 

; segment F 
4,42,43,42,2,43,45,43,4,44,43,44,-1 

; segment G 
$1111110 ; maaritellaan 7-segmenttinayton 
%0110000 ; numeroissa palavat segmentit 
%1101101 
*$1111001 
%0110011 
$1011011 
$1011111 
%1110000 
%1111111 
1111011 
0,4 osoite 4:lla jaolliseksi 
0,0,314,79 upper x,y , 
2,1 detailpen, blockpen 
CLOSEWINDOW IDCMPFlags 
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dc.1 WINDOWDRAG ! WINDOWDEPTH ! WINDOWCLOSE Flags 
dc.1 [0] gadgets 
dc.1 [0] checkmark 
dc.1 MyWinTitle title 
oldtime dc.1 0 screen 
dc.1 0 bitmap 
dC.w 320, 256, 320,256 min-max size 
dC.w WBENCHSCREEN type 
MyWinTitle dc.b ' DigiCLOCK v1.41',0 
libnames kirjastojen nimet&osoittimet 
end 
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$$$ DigiPlayer v 1.01 44% 


- Created 880219 by Jukka Marin - 


Ouack! 


Bugs: None known. 


Edited: 

- 880223 by JM -> v0.01 - added comments 

- 880223 by JM -> v0.02 - some cleanup 

- 880427 by JM -> vl.00 - Filename now supplied with the command. 
- Code compressed. 

- 880621 by JM -> vl.01 - Just added some comments. 


Tama ohjelma on julkaistu C=Lehden numerossa 3/88 heksadumppina. 
Ohjelmassa on kaytetty makroja, joiden listaukset loytyvat include- 
osasta tiedostosta JMPLibs.i. Ohjelma on kaannettavissa Metacomcon 
makroassemblerilla, kunhan JMPLibs.i on saatavilla. 


Ohjelma kayttää suoraan aanihardista eika varaa aanikanavia itselleen. 
siksi muiden aaniohjelmien ajaminen samaan aikaan saattaa kaataa koko 
koneen. Muiden kuin aanta kayttavien ohjelmien kanssa DigiPlayer sen 
sijaan toimii normaalisti. 


Ohjelmaan ei ole lisatty erityista kommentointia. Ohjelman lopussa on 
lyhyt englanninkielinen selostus kaytetyista makroista. Selostus 
liitettiin ohjelmaan ennen lahdekoodin levittamista. 


MEMF CHIP egu 2 

AUDOLC egu $DFF0A0 ; Channel 0 DMA start location 
AUDOLEN egu S$DFF0A4 ; Channel 0 DMA length 
AUDOVOL egu S$DFF0A8 ; Channel 0 volume 

AUDOPER egu SDFF0A6 ; Channel 0 period 

AUDOEN egu $01 ; Channel 0 enable 

AUD1LC egu $DFF0B0 ;Channel 1 DMA start location 
AUDI1LEN egu $DFF0B4 ; Channel 1 DMA length 
AUD1VOL egu $DFF0B8 ; Channel 1 volume 

AUD1PER egu $DFF0B6 ; Channel 1 period 

AUDIEN egu $02 ; Channel 1 enable 

SetAud egu $08000 ;Set bit mask 
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Clear egu [0] ;Clear bit mask 
DMAEN egu $0200 ; Enable audio DMA 
DMACONW egu $DFF096 ;DMA control register, write 
INTREO egu $DFF09C ; Interrupt reguest register 
INTREOR egu $DFF01E ; same, read 
INTENA egu $DFF09A ; Interrupt enable register 
INTENAR egu $DFF01C ; same, read 
xref — LVO00penLibrary ;External references 
xref — 1VOCloselLibrary 
xref — LVO00pen 
xref  LVOClose 
xref "LV00utput 
xref —LVORead 
xref ”LVOWrite 
xref "IVODelay 
xref LVOAllocMem 
xref —LVOFreeMem 
include "JMPlibs.i" ; Macro definitions 
Start movem.1 d2-d7/a2-a6,- (sp) 
move.1 &a0, CMDBuf start addr of cmd line 
clr.b -1(a0,40.1) add null to filename 


openlib Dos,cleanup 
print <'DigiPlayer (c) Jukka Marin 1988',13,10> 


move.l  CMDBuf(pc),a0 
tst.b (a0) 


bne name not null 
print —<'*** No file name ***',13,10> 
bra cleanup 
name not null move.l BYTES(pc),d0 
asl.1 $1,40 we need two buffers 
move.l fMEMF CHIP,dl of egual size 
lib Exec, AllocMem 
move.1 4d0,mychip 
bne mem ok 
print </*x*kk No CHIP RAM ***',13,10> 
bra cleanup 
; open file for reading: 
mem ok move.1 CMDBuf (pc) ,d1 filename pointer 
move.1 %F1005,42 filetype: read/write, oldfile 
lib Dos,Open call open-routine 
move.1 40, fileptr save filepointer 
bne looppi if zero, print an errormsg 
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looppi 


winttil 


wintti2 


endoffile 


cleanup 


clean10 


print 
bra 


move. 
move. 
move. 
lib 

move.1 


HHH 


move.1 
1szr.1 
bsr 


bsr 


move.1 
cmp.1 
bne 


move.1 
move.1 
move.1 
add.1 
1lib 
move.1 


move.1 
add.1 
1lsr.1 
bsr 


bsr 


move.1 
cmp.1 
beg 


move.1 
lib 
move.w 
and.w 
beg 


move. w 
move. w 


move.1 
beg 
lib 


move.1 
bea 
move.1 


</'*k*k* File not found ***',13,10> 


cleanup 


fileptr(pc),dl 
mychip (pc) , d2 
BYTES, d3 

Dos, Read 
d0,nextlen 


mychip (pc) ,a0 
41,40 


PlayABlock 
wait aud 


nextlen (pc) ,d0 
BYTES (pc) , d0 
endoffile 


fileptr(pc),dl 
mychip (pc) ,d2 
BYTES (pc) , d3 
d3,4d2 

Dos, Read 
d0,nextlen 


mychip (pc) ,a0 
BYTES (pc) , a0 
$1,40 
PlayABlock 


wait aud 


nextlen (pc) ,d0 
BYTES (pc) , d0 
looppi 


$1,d1 

Dos,Delay 

INTREOR, d0 
%0000011110000000,d0 
endoffile 


$ (Clear+AUDOEN+AUD1EN) , DMACONW 


exit program 


prepare to load file 
into this address 
this many bytes 

read them 

save % of bytes read 


start playing a block 


wait for an interrupt 


check if end of file 


get filepointer 

buffer address 

and bytecount 

calculate start address 
read bytes 

save % of bytes read 


play this block 


wait for an audio interrupt 


check if end of file 


if not, read next block 


wait until last block played 


stop Paula 


f%0000011110000000, INTREO 


fileptr(pc),dl 
cleanl0 
Dos,Close 


mychip (pc) , d0 
cleanll 
d0,a1 


close file 


free memory 
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move.1 BYTES(pc),d0 


as1.1 41,40 free both buffers 
lib Exec,FreeMem 
cleanll closlib Dos close dos.library 
movem.1 (sp)+,D2-D7/A2-A6 restore registers 
rts 
wait aud move.1 %1,4d1 waits for an audio interrupt 
lib Dos, Delay 


move.w INTREOR,d0 
and.w $%0000011110000000,40 


beg wait aud 
move.w 4%0000011110000000,1INTREG 
rts 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKÄKKKÄKKKÄKKÄKKKKÄKKÄKKKKKK 


; This routine sets parameters for Audio DMA channels 4%0 and 41. 
> It initializes data length from DO and data address from A0. 


KkkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKÄKKKKKKKKKKKKKKÄKKKKKÄKKKKÄ 


PlayABlock move.1l 4A0,AUDOLC ;Set parameters for voice 40 
move.w D0,AUDOLEN 
move.w %4%64,AUDOVOL 
move.w TimePeriod(pc),AUDOPER 


move.l 2A0,AUD1LC ;Set parameters for voice $f1 
move.w DO0,AUDILEN 

move.w %4%64,AUD1vVOL 

move.w TimePeriod(pc),AUD1IPER 


move.b Flaggie(pc),D1 

cmp.b $255,D1 ; Initializing cycle? 
bne ABlockExit 

;Set Audio DMA: 


move.w 4%(SetAud+DMAFEN+AUD0EN+AUD1EN) , DMACONW 
clr.b Flaggie 


ABlockExit rts 
TimePeriod dc.w 430 sample time / 279 ns 
BYTES dc.1 50000 buffers in CHIP RAM 
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Flaggie 
pad 
nextlen 
fileptr 
mychip 
— CMDBuf 


dc.b 255 my little Flaggie! 

dc.b [0] 

dc.1 [0] length of a block to play 

dc.1 (0) filepointer 

dc.1 0) pointer into my chip RAM 

dc.1 [0] filename pointer (command line) 
libnames 

end 


KKKKKKKKKKKKKÄKKKKKKKKKKKKKKKÄKKKÄKKKKÄKKÄKKKÄÄKÄKKKÄÄKÄKÄKKÄÄÄKKÄÄKKKKÄÄKÄÄKKKÄÄ 


jsr 


2626666426 2622 AA 


KÄEKKKKÄKKKUKKKKKÄKKKÄÄKÄKKÄKÄKÄKKÄKÄKÄKÄKÄÄÄKÄKKÄKÄÄKÄKKKÄKÄKKKÄKÄKÄKÄKKÄKKÄÄKÄÄKKKÄÄKKKÄKÄK 


READ THIS: 


This program was written using a macro assembler. Some 'mnemonics' 
in the code are names of macros, not assembler commands. 


Print, lib, openlib, closlib and libnames are macros written by JM 
lib loads the library base pointer into a6 and makes a jsr LVOxxx(a6) 
openlib loads execbase into a6 and then calls 1IV0OpenLibrary (a6) 
closlib loads execbase into a6 and then calls IVOCloselibrary (a6) 
Print prints the text using Write() of dos.library 

libnames contains library names and base pointers 

Calling Dos-library routines: 


move.1 DosBase(pc),a6 loads the base address of dos.library 
— LVO0pen (26) calls Open-routine 


Definition of dosname and library base pointer: 
 Doslib 


' DosBase 


dc.b '/ dos.library' ,0 
cnop 0,2 
do.1 [0] 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
*x 
ki 
x 
* 
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$$ Intuition-esimerkki %$f% 


- Created 880730 by JM - 


Tama esimerkki esittelee useiden Intuition-kirjaston rutiinien kayttoa. 
Ohjelman tutkimista helpottaa, jos seuraa kirjan Intuition-rutiineja 
esittelevaa osaa. 


Ohjelma vaatii kaantyakseen include-tiedostoja. Jos niita ei haluta 
kayttaa, voidaan vakiot (SELECTDOWN jne.) korvata include-tiedostoista 
loytyvilla lukuarvoilla. 


Ohjelma on yksinkertainen piirtelyohjelma, jolla voi piirtaa viivoja 
kahdeksalla varilla ja tayttaa halutulla varilla suljettuja alueita. 


Ohjelma ei ole mikaan DPaint II, mutta antanee jonkinlaisen kuvan 
Intuitionin ja IDCMP-jarjestelman kaytosta. Enemman tietoa IDCMP:sta 
loytyy Intuition Reference Manual -kirjasta. 


Ohjelman kayttoohjeet: 


- ajetaan CLI:sta kasin (runilla tai ilman) 

- avaa nayton y-paikkaan 270 ja siirtaa sen ylos hitaasti 

- avaa ikkunan, jonka kokoa ja paikkaa voi saataa 

- numeronappaimet 1...8 valitsevat piirtovarin, joka nakyy 
hiiren osoittimessa 

- kun vasen hiiren nappula painetaan pohjaan, ohjelma merkitsee 
viivan alkupisteen (mitaan ei nay!!!) 

- kun vasen nappula vapautetaan, ohjelma piirtaa viivan 

- ikkunan otsikkopalkkiin ei voi piirtaa, mutta raameihin voi 

- kun painetaan oikeanpuoleista nappulaa, ohjelma tayttaa alueen 
kaytossa olevalla piirtovarilla 

- ikkunan otsikkopalkkia ei voi tayttaa 

- naksauttamalla ikkunan sulkunappulaa ohjelma paattyy ja 
naytto valuu alas 


Bugs: None known. 


Edited: 


- 880730 by JM, TM - Kommentoitu, lisatty Diskfont 


include "intuition.i" oma, erikoinen tiedosto, 
joka sisaltaa lahes kaikki 


muut include-tiedostot 


nayton leveys 
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SCRY egu 256 ; nayton korkeus 
MINY eau 11 ; otsikkopalkille varattu 
tila 


KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄ 


* *x 
* WINDOWFLAGS: * 
K=======----=: = x 
x x 
* WINDOWCLOSE aikaansaa sulkunappulan ikkunan vasempaan ylakulmaan x 
* WINDOWDRAG mahdollistaa ikkunan liikuttelemisen hiirella * 
* WINDOWSIZING mahdollistaa koon saatamisen x 
* NOCAREREFRESH estaa Intuitionia pyytämästä ikkunan virkistystä x 
* RMBTRAP estaa valikkojen kayton, mahdollistaa oikeanpuoleisen x 
x hiiren nappulan kayttamisen omiin tarkoituksiin w 
* * 
* IDCMPFLAGS: * 
Kussosossammssa x 
*x * 
* CLOSEWINDOW kertoo Intuitionille, etta ohjelmamme haluaa tietaa, * 
x milloin kayttaja naksuttaa sulkunappulaa x 
* MOUSEBUTTONS kertoo Intuitionille, etta ohjelma haluaa tietaa hiiren * 
x nappuloiden naksutuksista w 
* VANILLAKEY kertoo Intuitionille, etta haluamme tietaa myös nappai- * 
joi mien painallukset. x 
* x 
* Intuition valittaa meille pyytamamme tiedot vain siina tapauksessa, x 
* etta ikkunamme on aktiivinen (valittu). x 
* * 
* Kun Intuition huomaa, etta jokin em. tapahtumista on sattunut, se x 
* lahettaa ohjelmallemme viestin asiasta. Talloin ohjelma poistuu Wait-* 
* rutiinista, lukee viestin GetMsg:lla, ottaa siita tarvitsemansa x 
* arvot ja vastaa viestiin ReplyMsg:lla. Silmukassa poistetaan kaikki * 
* mahdollisesti odottamassa olevat viestit (kunnes GetMsg palauttaa x 
* nollan). * 
*x * 
KA*KKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKK 
WINDOWFLAGS set WINDOWCLOSE ! KINDOWDRAG ! WINDOWSIZING 

WINDOWFLAGS set WINDOWFLAGS! NOCAREREFRESH! RMBTRAP 

IDCMPFLAGS set CLOSEWINDOW! MOUSEBUTTONS ! VANILLAKEY 

RasteriKoko egu ( (SCRX+15) /16*2) *SCRY ; Floodin tyoalueen koko 


KEKKKKKKKKKKKKKKKKKKKKKKKKEKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* * 
* Maaritellaan kutsuttavat kayttojarjestelmarutiinit: x 
* * 


KEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 
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xref — LvOoopenLibrary 
xref — LVOCloseLibrary 
xref —LVOWait 

xref LVOGetMsg 


xref " LVOReplyMsg 
xref —LVOAllocMem 
xref — LVOFreeMem 
xref — 1VO0penScreen 
xref —LVO0penWindow 
xref — LVOCloseScreen 
xref —LVOCloseWindow 
xref — LVOMoveScreen 
xref LVOMove 

xref — LVODraw 

xref —LVOSetAPen 
xref — LVOFlood 

xref — LVOLoadRGB4 
xref — LVOSetRGB4 
xref — LVORectFill 
xref —LVOText 

xref LVOOpenFont 


xref " LvocloseFont 


xref — LvOoopenDiskFont 


Exec-kirjasto 


Intuition-kirjasto 


Gfx-kirjasto 


Diskfont-kirjasto 


* PUSH-makro tallettaa prosessorin rekistereja pinoon. Makro on esitelty 
* kirjan makroja kasittelevassa kohdassa. 


push 


macro * push <reg list | all> 
ifc LNI25 Vall? 

movem.1 d0-d7/a0-a6,-(sp) 

endc 


ifnc NIL, Tall! 
movem.1 V1,-(sp) 
endc 

endm 


* PULL-makro ottaa prosessorin rekisterien arvo 
* kirjan makroja kasittelevassa kohdassa. 


pull 


macro * pull <reg list | all> 
ifc NX, /all? 

movem.1 (sp)+,d0-d7/a0-a6 

endc 

ifnc EN47, Call! 

movem.1 (sp)+,11 

endc 

endm 


t pinosta. Makro on esitelty 
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* * 


* 2 X A A X A A A * X * * 


OPENLIB-makro avaa halutun kirjaston. Se voidaan korvata normaalilla 
koodilla: 


move.l 4,a6 


lea kirjaston nimi(pc),al 
moveg.1 $0,d0 
jsr LvOOpenLibrary (a6) 


move.l d0,perusosoite 
Esimerkki: Avataan Intuition-kirjasto: 


move.l 4,a6 


lea $Intuition nimi(pc),al 
moveg.1 %0,d0 
jsr LVOoopenLibrary (a6) 


move.1 %<d0,IntuitionBase 


Ohjelman lopussa on maariteltava kirjaston nimi ja perusosoitteelle 
varattava tila: 


IntuitionBase dc.1 O 
Intuition nimi dc.b ”intuition.library',0 


HUOMAA: 
Kirjaston perusosoitteen on sijaittava PARILLISESSA osoitteessa! 
Muutoin move.1 ao. osoitteeseen/pois siita aiheuttaa gurun nro 3. 


openlib macro *LIB ID, CLEANUP openlib Dos, cleanup 
DA1 set 1 
move.1 4,a6 
lea N1Lib (pc) ,a1 
moveg.1 0,40 
jsr — LVOOpenLibrary (a6) 
move.l &d0, VlBase 
ifnc INDIA 
beg N2 
endc 
endm 


* »* 


* * *» * *» * *» * 


CLOSLIB-makro sulkee halutun kirjaston. Se voidaan korvata normaalilla 
koodilla: 


move.l1 4,a6 
move.l] perusosoite(pc),al 
jsr — LVOCloseLibrary (a6) 


CLOSLIB-makro vastaa muuten yllaolevaa koodia, mutta se tarkistaa ennen 
kirjaston sulkemista, onko kirjasto todella avattu. Jos perusosoite on 
nolla, CLOSLIB ei sulje kirjastoa (minkaan kirjaston perusosoite ei voi 
olla nolla). 
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closlib macro *LIB ID closlib Dos 
move.l = V1Base(pc),al 
move.1 al,d0 


beg CLIBVG 

move.1 4,a6 

jsr — LVOCloseLibrary (a6) 
cLIBVG clr.1 — V1Base 

endm 


* 


LIB-makro kutsuu haluttua kirjastorutiinia. Se voidaan korvata normaalilla 
koodilla: 


» 


* move.]l perusosoite(pc),a6 
* jsr — LVOrutiini (a6) 
* 
* Jos kutsuttava kirjasto on Exec, LIB-makro lataa kirjaston perusosoitteen 
* suoraan osoitteesta 4. Muuten perusosoite luetaan kirjastoBase-paikasta, 
* esim. IntuitionBase. 
lib macro *LIB ID,ROUTINE lib Dos, Delay 
ifnc 1N1/7/Exec' 
move.l1 = |1Base(pc),a6 
endc 
ifc 1N1/,'Exec' 
move.1 $4,a6 
endc 
jsr —LVO0V2 (26) 
endm 


**kkkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* * 
* Aluksi avataan Dos, Intuition, Graphics ja Diskfont-kirjastot. * 
* Jos joku kirjastoista ei avaudu, poistutaan kohtaan Loppu. * 
* Tama on OPENLIB-makron ominaisuus. * 
* * 
x * 


KkkKKKKKKKÄKKKKKKKÄKKKÄKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKK 


PaaOhjelma openlib Dos,Loppu 
openlib Intuition, Loppu 
openlib Gfx, Loppu 
openlib Diskfont,Loppu 
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n i is S: 


KEKKKKKKKKKKKKKKÄKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKÄKKKKKKKKKAÄKKKKKKKKKKKKKKKKKK 
* 


»* 


* Seuraavaksi avataan fontti. Ensin kokeillaan, onko fontti jo muis- * 
* tissa. Ellei, kaytetaan OpenDiskFont-rutiinia lataamaan ne levykkeel-* 
* ta. Fontin on loydyttava boottilevykkeen (se levyke, jolla kone x 
* kaynnistettiin) fonts-hakemistosta. Muuten poistutaan ohjelmasta. * 
* * 


KIKKKKKKKKKKKKKKUÄKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKÄKKKA 


AvaaFontti lea TextAattr (pc) ,a0 ; halutun fontin nimi etc. 
lib Gfx, OpenFont 
move.1 &d0,0maFontti ; osoitin fonttiin 
bne AvaaNaytto ; fontit lioytyivat muistista 
AvaalevyFontti lea TextAttr (pc) ,a0 ; halutun fontin nimi etc. 
lib Diskfont,OpenDiskFont ; onks se fontti levylla? 
move.l1 d0,0maFontti ; osoitin fonttiin 
beg Loppu ; jos fonttia ei oo, POIS!! 


KERKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKA 
* 


* 

* Seuraavaksi avataan naytto, jonka resoluutio on 320 x 256 ja bitti- x 
* tasojen lukumaara 3 (varien maara 8). * 
* Jos naytto ei avautunut (muisti lopussa tms.), poistutaan kohtaan * 
* loppu. x 
* * 
KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 
AvaaNaytto lea newscreen (pc) ,a0 

lib Intuition, OpenScreen 

move.1 <d0,MinunNaytto 

beg Loppu 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


x * 
* Sitten avataan uuteen nayttoon ikkuna. Ikkunan NewWindow-structureen * 
* kirjoitetaan asken avatun nayton Screen-structuren osoitin, jotta x 
* kayttojarjestelma tietaa, mihin nayttoon ikkuna halutaan. * 
* Jos ikkuna ei avautunut (muisti lopussa tms.), poistutaan kohtaan x 
* loppu. * 
* * 
KAKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 
AvaalIkkuna move.1 MinunNaytto(pc),NaytonOsoite 

lea newwindow (pc) ,a0 

lib Intuition, OpenWindow 

move.l <d0,MinunIkkuna 

beg Loppu 
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KKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKÄKKKKÄKKKKKÄKKKKÄKKKKKKÄKÄKKKKÄKÄKKKÄKKKKKÄKKKKK 


* 
Nyt selvitetaan ikkunaan liittyvan RastPort-structuren osoite piirto- * 
rutiineja varten. Alempana selvitetaan ViewPort-structuren osoite. = 
Osoitteet talletetaan RastPort- ja ViewPort-paikkoihin, jotka on * 
maaritelty ohjelman lopussa. HUOMAA: Kaikkien LONG-tyyppisten x 
(32-bittisten) lukujen on sijaittava PARILLISISSA osoitteissa!!! x 

* 

x 


* 
* 
* 
* 
x 
* 
x 
* 


KKKKKKKKKÄKKKÄKÄKKÄKKKKKKÄKKKÄKKÄKKÄKKÄKÄKKÄKKKKÄKKKÄKKKKKKKÄKKKKKKKUKKÄKKKKKÄKÄA KA 


OtaRastPort move.1l MinunIkkuna (pc) ,a0 
move.l wd RPort(a0),rastport 


OtaViewPort move.1 MinunNaytto(pc) ,a0 
lea sc ViewPort (a0) ,a0 
move.1 a0,viewport 


KKKKKKKKKKKKKKÄKKKKKKKKÄKKKKKKKÄKÄKKKKKKÄKKKÄKKKKKÄKKKKKKÄKKKKKKÄKKKÄKKKÄKKÄKKKKÄKKÄ 


* * 
* Nyt varataan muistia valiaikaiselle bittikartalle, jota Flood-rutiini * 
* tarvitsee. Muistia varataan Exec-kirjaston AllocMem-rutiinilla. * 
* Varattavan muistin koko on laskettu ohjelmalistauksen alussa. x 
* Varattavan muistin on sijaittava CHIP-RAMissa, jotta blitter voisi * 
* kayttaa sita. Jos muistia ei saatu, poistutaan kohtaan loppu. x 
* Kun muisti on varattu, siirretaan TmpRas-structuren osoite RastPort- * 
* structuren ao. kohtaan, jotta kayttojarjestelma tietaisi muistialueen * 
* sijainnin. X: 
* * 
x * 


KKKKKKKKKKKKKKKÄKKKKKKKKKÄKKKKKKKKKÄKKÄKKÄKKKKKKÄKKKÄKKÄKKKÄKKÄKKÄKKKKÄKKKÄKKÄKK 


VaraaTmpRas lea tmpras(pc),a2 
move.l %4RasteriKoko,d0 
move.1 <d0,4(a2) 


TmpRas-structuren osoite 
varattavan muistin maara 
kerrotaan se myös 


kayttikselle 
moveg.1 42,41 ; muistin tyyppi: CHIP RAM 
lib Exec, AllocMem 
move.1 40, (a2) ; talletetaan varatun muistin 
alkuosoite 
beg Loppu 
AsetaTmpRas move.1 rastport(pc),a0 ; kerrotaan RastPortille, 
move.1 a2,rp TmpRas(a0) ; missa TmpRas-structure on 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKÄKKKKÄKKKKÄKKÄKKÄKKKKÄKKÄ 


* * 
* Seuraavaksi asetetaan kaikki nayton 32 varia LoadRGB4-rutiinilla. * 
* * 


K*KKKKKKKKKKKUÄKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKÄKKÄKKKKKÄKKKKÄKKKKÄKKKKKKK 
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AsetaVarit move.1 viewport(pc),a0 ; mihin varit asetetaan 
moveg.1 8,40 ; varien lukumaara 
lea VariKartta(pc),al ; varitaulukon osoite 
lib Gfx, LoadRGB4 ; VARIA! 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKÄKKKKK 


* x 
* Asetetaan viela piirtovari ja osoittimen vari omalla aliohjelmalla. * 
* * 


KKKKKKKKKKKKKKKÄKKKKKÄKÄKKÄKKÄKKKÄKKKÄKÄKKÄKKKÄKÄKKÄKKKKÄKKÄKÄKÄÄKÄKKÄKÄÄKÄKÄKÄKKKÄKÄKKÄÄKÄKKÄ 


moveg.1 f1,43 
bsr AsetaVari 


KKKKKKKKÄKKKÄKKKÄKKKÄKKÄKKÄKÄKKKÄÄKKÄKAÄKÄKKKÄKÄKKÄKÄKÄKKÄKÄKÄÄÄKÄKKÄKÄKÄKÄÄKÄKÄKÄKÄKÄKKÄ 


* * 
* Nostetaan naytto ylos kuvaruudun alareunasta: x 
* * 


KIKKKKKKKKKKKKKÄKKKKKKKKÄKÄKKKÄKKÄKKKKÄKKÄÄKKÄKKKÄKÄKKKÄKKÄKKÄKÄKKÄKKKKÄÄKÄKÄKKKKÄKÄKKÄKK 


move.w %4269,d7 

SiirraYlos moveg.1 0,40 
moveg.1 $-1,d1 
move.1 MinunNaytto(pc),a0 
lib Intuition,MoveScreen 
dbf d7,SiirraYlos 


laskuri 

dx = 0 

dy = -1 (ylos) 
siirrettava naytto 
SIIRRA! 

kunnes ylhaalla 


NIITIT 


KKKKKKKKÄKKKKKKKKÄKKKKÄKKKÄKKÄKKKÄKKKÄKÄKKKKÄKÄKKKKKKKKKKÄKKKKKKÄKKÄKKÄKKKKÄKÄKKKÄKKÄK 


* *x 
* Kutsutaan aliohjelmaa, jossa piirtaminen tapahtuu. Kun kayttaja x 
* naksauttaa ikkunan sulkunappulaa, palataan aliohjelmasta takaisin. x 
x E 


KAKKKKKKKKKKÄKÄKKÄKÄKÄKÄÄKKÄKÄKKÄKKÄKKÄKKÄKKÄKKÄKÄKÄKKÄKKKÄKKÄKKÄKÄKKKKÄKKKÄKÄKKKKÄÄKKÄKKKKKK 


bsr event 


KKKKKKKKKKÄKÄKKKKKKÄKKKÄKKKKKKÄKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


x x 
* Lasketaan naytto takaisin kuvaruudun alareunaan: X 
x x 


KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


move.w 4269,d7 

SiirraAlas moveg.1 0,40 
moveg.1 %1,d1 
move.1 MinunNaytto(pc),a0 
1lib Intuition,MoveScreen 
dbf d7,SiirraAlas 


laskuri 

dx = 0 

dy = 1 (alas) 
siirrettava naytto 
SIIRRA! 

kunnes alhaalla 


RIISIIN 
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KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKK 


Tahan tullaan, jos jokin kirjastoista, 


* 
* 
x 
* ohjelmasta poistumista. 
* 
* 


KK*KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKÄKÄKKKKKKKÄKKKKKK 


ikkuna tai naytto ei auennut. 
Kaikki varatut ja avatut jutut vapautetaan ja suljetaan ennen 


Loppu tst.1 MinunIkkuna ja 
beg Loppul j- 
SuljeIkkuna move.1 MinunIkkuna (pc) ,a0 
1lib Intuition, CloseWindow 
Loppul tst.1 MinunNaytto 5 
beg Loppu2 ä 
SuljeNaytto move.l MinunNaytto(pc),a0 
lib Intuition, CloseScreen 
Loppu2 move.l1 +tmpras(pc),d0 ; 
beg Loppu3 H 


VapautaTmpRas move.1 4d0,al 
move.l +tmpras+4(pc),d0 


lib Exec, FreeMem 
Loppu3 move.l OmaFontti (pc),d0 
SE! 

beg Loppu4 

move.1l 4d0,al 

lib Gfx,CloseFont 
Loppu4 closlib Diskfont 


closlib Intuition 


closlib Gfx 
automaattisesti, 
closlib Dos 


clr.1 d0 
virhetta! 
rts 


N 


* 
* 
* 
* 
* 
* 


onko ikkuna auki? 
jos ei, ei suljeta sita! 


onko naytto auki? 
jos ei, ei suljeta sita! 


onko muistia varattu? 
jos ei, ei vapauteta sita! 


jos fontti avattu, SULJE 


suljetaan kirjastot. 
closlib testaa 

oliko kirjasto auki vai ei. 
tieto DOSsille: ei 


ohjelma LOPPUUUUU... 


231 


Esimerkkiohjelmat 


KkkKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


Aliohjelma, 


joka kasittelee IDCMP:n antamat tiedot. 
"Intuition Direct Communication Message Port". 


IDCMP tarkoittaa 


IDCMP:n avulla ohjelma saa tietaa, painettiinko hiiren nappuloita, 
kaytettiinko nappaimistoa, valikoita tai nappuloita. 
Tassa ohjelmassa tutkitaan vain hiiren nappuloita ja nappaimistoa. 


painaminen aiheuta ikkunan valikkopalkin ilmaantumista nayton yla- 


reunaan. 


Koska kaikkia tapahtumia odotetaan Wait-rutiinissa, ei ohjelma kuluta 


koneen aikaa, 


x 
* 
* 
x 
x 
* 
* Koska RMBTRAP-lippu on asetettu, 
* 
x 
* 
* 
* 
* 
* 


ellei sita todella kayteta. 


* 
* 
* 
* 
* 
* 
* 
ei hiiren oikeanpuoleisen nappulan x 
* 
x 
* 
x 
* 
* 
* 


KKKKKKKKKKKKKKÄKKÄKKKÄKKKKKÄKKKÄKKKKÄKKKKKKKKÄKKKKÄÄKKKKKKKKKKKKKKKKKÄKKKÄ 


event 


eventloop 


VANILLAKEY) 


koodi) 


eventdone 


piirreta 


move.1 
move.1 
moveg.1 
move.b 
moveg.1 
bset.1 
lib 
move.1 
lib 
tst.1 
beg 


move.1 
move.1 


moveg.1 
moveg.1 
moveg.1 
move.w 


move. w 
move.w 


lib 
bra 


cmp.1 
bne 
cmp.1 
bne 
cmp.1 


blo 

move.1 
move.1 
move.1 


MinunIkkuna (pc) ,a0 
wd UserPort (a0) ,a2 


407 d1 

15 (a2),d1 
40,40 

d1,40 

Exec, Wait 
a2,a0 

Exec, GetMsg 
d0 
eventdone 


d0,a1l 
im Class(al),d2 


10,43 
H0,44 
$0,45 
im Code (al),4d3 


im MouseX (al) ,d4 
im MouseY (al) ,d5 


Exec, ReplyMsg 
eventloop 


HMOUSEBUTTONS, d2 
NotButton 
HSELECTDOWN, d3 
NotSelectD 
YMINY,4d5 


event 
d4,40 
a5,d1 
rastport (pc) ,al 


ikkunan osoitin 
UserPort-osoitin 


signaalibitin numero 
signaalibitti 
odotetaan jotakin 


UserPort-osoitin 
otetaan Intuitionin viesti 


viestin osoitin 
viestin luokka (esin. 


nollataan rekistereja 


koodi (esim. nappaimen 


hiiren x-koordinaatti 
hiiren y-koordinaatti 


vastataan viestiin 
onko lisaa viesteja? 


oliko hiiren nappula? 
oliko vasen nappula alas? 


jos liian ylhaalla, ei 


hiiren koordinaatit Movelle 
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NotSelectD 


Drawille 


NotSelectU 


komentoa 


NotButton 


NotClose 


NotVanilla 


lib 
bra 


cmp.1 
bne 
cmp.1 
blo 
move.1 


move.1 
move.1 
lib 
bra 


cmp.1 
bne 
cmp.1 
blo 
move.1 
move.1 
moveg.1 
move.1 
1lib 
bra 


cmp.1 
bne 
rts 


bne 


Gfx,Move 
event 


$SELECTUP,d3 
NotSelectU 
$MINY,4d5 
event 

d4,4d0 


4a5,d1 
rastport (pc) ,al 
Gfx,Draw 

event 


$MENUDOWN, d3 
NotButton 
FMINY,d5 

event 

d4,d0 

d5,d1 

41,42 
rastport (pc) ,al 
Gfx,Flood 
event 


HCLOSEWINDOW, d2 
NotClose 


$VANILLAKEY,d2 
NotVanilla 
$'1',43 
event 
$'8',43 
event 
*'1',4a3 
40,40 
4$££, 43 
AsetaVari 
event 


event 


RYTIN 


NYT 


siirretaan piirtokynaa 
seuraava tapahtuma... 


oliko vasen nappula ylos? 
ollaanko liian ylhaalla? 


hiiren koordinaatit 


Piirretaan VIIVA!! 
ja seuraava komento... 


oikea nappula? 

ollaanko liian ylhaalla? 
otetaan koordinaatit 
asetetaan moodi 

ja TAYTETAAN ALUE! 
odotetaan seuraavaa 
sulkunappula? 

jos oli, poistutaan. 
oliko nappain? 

jos ei, niin ei sitten! 
pienempi kuin "1"? 
suurempi kuin "8"? 
muutetaan arvoksi 0...7 
ylimmat bitit nollataan 


asetetaan piirtovari! 
ja seuraavaa odottamaan... 


jos ei ollut mikaan 
tunnettu komento, 
jatketaan odottamista. 


233 


Esimerkkiohjelmat 


KKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKÄKÄKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKÄKKKKKKK 


* 


* 


* Tama aliohjelma asettaa d3:ssa olevan arvon piirtovariksi ja hiiren * 
* osoittimen variksi. 


* 


Osoittimen reuna piirretaan himmeammalla savylla.* 


* 


KKKKKKKKKKÄKKKKKKKUKKKKKKKKKKÄKKKKKKKKKKKKÄKUKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKK 


AsetaVari 


taulukkoon 


Blue, 


paavari 


reunavari 


move.b 
move.1 
1lib 


lea 
asl.w 


move. w 
moveg.1 
moveg.1 
moveg.1 
move.b 


and.b 
lsr.w 
move.b 
and.b 
1sr.w 
move.b 
and.b 


move.1 
moveg.1 
move.1 
lib 


move.1 
asr.w 
asr.w 
asr.w 
moveg.1 
move.1 
lib 


rts 


43, d0 
rastport (pc),al 
Gfx,SetAPen 


VariKartta(pc),a0 


1,43 


0 (a0,d3.w),d7 
40,44 
0,42 
10,43 
d7,4d3 


415,43 
44,47 
a7,d2 
415,42 
44,47 
47, d4 
415,44 


d4,4d1 

117,40 
viewport (pc) ,a0 
Gfx, Set RGB4 


d4,d1 

$1,d1 

$1,42 

41,43 

118,40 
viewport (pc) ,a0 
Gfx,SetRGB4 


vari SetaAPen:lle 


tutkitaan RGB-komponentit 
varinumero indeksina 


piirtovarin RGB 

nollataan aluksi R 

G 

ja B 

Erotellaan taulukon varista 


Green 


ja Red 


asetetaan osoittimen 


jaetaan RGB-arvot kahdella, 
jolloin saadaan himmeampi 


savy 


asetetaan osoittimen 
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kkkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKÄKKKUÄKKKKKÄKKKKKKKKKKKÄKKKKKÄK 


x x 
* Nayton maaritteleva NewScreen-structure: * 
x * 


KA*KKKKKKKKKKKKKKKUKKKUKKKKKKKKKKEKKKUKKKKKKKKKUEKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKK 


newscreen dC.w 0,270,320,256 koordinaatit ja koko 
dc.w 3 bittitasojen lukumaara 
dc.b 7,2 otsikkopalkin varit 
dc.w je) resoluutio = LORES 


dC.w CUSTOMSCREEN 
dc.1 TextAttr 
dc.1 Otsikko 

dc.1 0,0 


tyyppi 
kaytettava fontti 
otsikkopalkin teksti 


kkkkkKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKEKKKKKKKKKKKKKKKKKK 


*x* * 
* Ikkunan maaritteleva newwindow-structure: x 
* Screen-structure-osoittimen ohjelma kirjoittaa itse sille varattuun * 
* paikkaan nayton avaamisen jalkeen. Osoitintahan ei tunneta ennen x 
* nayton avaamista!!! i * 
* * 
* * 


KKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKÄKKKKKÄKKKÄKÄKKÄKKÄKKKÄKKÄKKÄKÄKKKÄKÄKÄKKKKKÄ 


newwindow dc.w 50,20,100,100 ; koordinaatit ja koko 
dc.b 5,6 ; otsikkopalkin varit 
dc.1 IDCMPFLAGS ; IDCMP-liput 
de.1 WINDOWFLAGS ; liput 
dce.1 0,0 ; ei nappuloita, ei merkkia 


dc.1 IkkunanOtsikko ; otsikkopalkin teksti 
NaytonOsoite de.1 [0] ; osoitin Screen-structureen 

dc.1 [0] ; ei osoitinta BitMap-structureen 

dc.w 0,0,320,256 ; minimi/maksimikoko 

dc.w CUSTOMSCREEN ; tyyppi 


tmpras dc.1 (0) ; tila TmpRas-structurelle 
dc.1 (0) 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKÄKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKÄKKKKK 


* * 
* Fontin maaritteleva TextAttr-structure: x 
* * 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKÄK 


TextAttr dc.1 FontinNimi ; fontin nimi 
de.w 8 ; fontin korkeus 
dc.b [0] ; ei lippuja 
dc.b [0] 
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FontinNimi dc.b ' ruby.font',0 ; itse fontin nimi 
IkkunanOtsikko dc.b ' Ikkunan OtsikkoPalkki',0 
Otsikko dc.b '/OtsikkoPalkki”',0 
ds.1 je) ; tasataan osoite 4:lla jaollisekt 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKAKÄKKKKKKKK 
HUOMAA: 


x * 
* * 
* * 
* Merkkijonojen maarittelemisen jalkeen osoite on tasattava x 
* parilliseksi esim. ds.1 0 -komennolla, jotta seuraavat sanat (dc.w) x 
* ja pitkat sanat (dc.1) tulisivat varmasti parillisiin osoitteisiin. x 
* Jos merkkijonon pituus loppunollineen on parillinen, tama ei ole x 
* tarpeen (edellyttaen tietysti, etta merkkijono alkaa parillisesta x 
* osoitteesta). x 
x x 
x * 


KKKKKKKKKKKÄKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKKKKKKKÄKKKKKÄKKK 


VariKartta dC.w $000 ; musta (nappula 1) 
dc.w Sfff ; valkoinen (nappula 2) 
dc.w $£50 ; punainen (nappula 3) 
dc.w $fa2 ; oranssi (nappula 4) 
dC.w Se2a ; violetti (nappula 5) 
dc.w $44d0 ; vihrea (nappula 6) 
dc.w $65f ; sininen (nappula 7) 
dc.w $fe2 ; keltainen (nappula 8) 


MinunIkkuna dc.1 10] ; tila Window-structuren osoitteelle 
MinunNaytto da 0 ; tila Screen-structuren osoitteelle 
OmaFontti dc.1 10] ; tila fontin osoittimelle 
rastport dc.1 [0] ; tila RastPort-structuren 
osoitteelle 
viewport dc.1 (0) ; tila ViewPort-structuren 
osoitteelle 
 Gfxlib dc.b ' graphics.library' ,0 ; kirjastojen nimet 
—IntuitionLib dc.b 'intuition.library',0 
DiskfontLib dc.b ”diskfont.library' ,0 
 Doslib dc.b 'dos.library',0 

ds.1 [0] ; tasataan osoite 4:lla jaolliseksi! 
 GfxBase dc.1 o ; grafiikkakirjaston perusosoite 
— IntuitionBase <dc.1 [0] ; intuition-kirjaston perusosoite 
 DiskfontBase dc.1 [0] ; diskfont-kirjaston perusosoite 
 DosBase dc.1 [0] ; dos-kirjaston perusosoite 

end ; LOPPU! 
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$$ Keskeytysesimerkki vl.5 4tff 


- Created 880802 by JM - 


Tama ohjelma esittaa, miten oma keskeytysrutiini liitetaan kayttojarjes- 
telmaan. Keskeytysrutiini liitetaan ketjuun, joka suoritetaan 50 kertaa 
sekunnissa. 


Ohjelma sammuttaa kuvaruudun halutun ajan kuluttua, ellei nappaimia 
painella, hiirta liikuteta tai ellei(vat) levyasema(t) ole kaytossa. 
Haluttu odotusaika ennen ruudun sammuttamista annetaan komennon perassa 
sekunteina (1...9999 s). Kun kayttaja alkaa taas touhuta, ruutu syttyy. 


Bugs: None born. 


Edited: 
- 880802 by JM -> vl.0 - kommentit 
- 880803 by JM -> vl.5 - lisatty CTRL+C 
include "jmplibs.i" omia makroja 
include "hards.i" hardisrekistereja 
include "exec.xref" maarittelee Execin rutiinit 
include "dos.xref" maarittelee Dossin rutiinit 
keyboard egu $bfec01 nappaimiston rekisteri 
mouse0 egu $dff00a hiiren O rekisteri 
mousel egu $dff00c hiiren 1 rekisteri 
diskctrl egu $b£d100 levyaseman ohjausrekisteri 
nappis egu (0) offset-arvot omaan taulukkoon 
hiiri0 egu 2 
hiiril egu 4 
levyas egu 6 
laskuri egu 8 
raja egu 12 
dmasailo egu 16 
SAMMUTUS egu %0000000110100000 pysayttaa Copperin, Spritet ja 
nayton 
INTB VERTB egu 5 keskeytystyyppi Vertical Blanking 
CTRL C egu 12 bitti, joka ilmaisee CTRL+C:n 
painamisen 


237 


Esimerkkiohjelmat 


Start 


luku 


oletusarvoa 
oletusarvoa 
arvo 


viive asetettu 


push 
bsr 


mulu.w 
bvs 


beg 


move.1 


d2-47/a2-a6 
ota luku 


450, 40 
viive asetettu 


viive asetettu 


d0,IData+raja 


openlib Dos, cleanup 


otetaan komentorivilla oleva 


kerrotaan 50:lla 
jos virhe, kaytetaan 


jos nolla, kaytetaan 


asetetaan kayttajan haluama 


KEKKKKKKAKÄKKKKKKKKKKKKKKKKKKKKKUKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKÄKKKÄKKKKKKKK 


Keskeytystyyppi maaraa, minka keskeytyksen tapahduttua tata rutiinia 
lueteltu mm. include-tiedostossa. 


kutsutaan. 


50 kertaa se 


Tyypit on 


kunnissa. 


Siksi kayttajan antama viivearvo kerrotaan 
50:lla (laskuri laskee viideskymmenesosasekunteja). 


E 

* * 
*x * 
* x 
* INTB VERTB tarkoittaa vertical blanking -keskeytysta, joka tapahtuu * 
* * 
* * 
* x 
* * 


KEKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKKÄKUKKKÄKKKKKKKKKKUKKKKKKKKKÄKKÄKKKKKKKKKK 


cleanup 


moveg.1 
lea 
1ib 


moveg.1 
bset.1 
1lib 


moveg.1 
lea 
1ib 


closlib 
pull 
rts 


IINTB VERTB,d0 
keskstruc(pc),al 
Exec,AddIntServer 


$0,40 
FCTRL C,d0 
Exec,Wait 


HINTB VERTB,d0 
keskstruc(pc),al 
Exec, RemIntServer 


Dos 
d2-d47/a2-a6 


liitetaan systeemiin 
oma keskeytysrutiini 


odotetaan, kunnes kayttaja 
painaa CTRI+C tai kayttaa 
break-komentoa 


poistetaan oma rutiini 
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KÄIKKKKKKKKKKKKÄKKKKÄKKÄKKÄKKÄKKKKÄKKKÄKKKÄKKKKÄKKÄKKKKÄKKKÄKÄKKKÄKKKKKKKÄKÄKKKÄKKÄKKÄKKKÄ 


x * 
* ota luku muuntaa a0:n ilmaisemasta osoitteesta alkavan ASCII- * 
* desimaaliluvun binaariksi rekisteriin d0. Rutiini kasittelee oikein * 
* ainakin 1...4 -numeroiset luvut. Koska mulu.w ei ota kuin d0:n 16 * 
* alimmasta bitista, rutiini ei anna oikein yli 16-bittisia tuloksia. x 
* * 
* Lukua otetaan, kunnes loytyy ensimmainen ei-numeerinen merkki. Jos ko 
* ensimmainen merkkikaan ei ole numero, palautetaan tuloksena nolla. » 
* * 
KKKKKKKKKKÄKKKÄKKKÄKKKKKKKKKKKKKKKKKÄKKKÄKKKÄKKKÄKKKÄKÄKKKÄKKÄÄKKÄKKÄÄKKEÄKKKÄKUKKKKKKÄ 
ota luku moveg.1 %0,d0 nollataan tulos 
E moveg.1 $0,d1 nollataan valiaikainen rekisteri 
ota seuraava move.b (a0)+,d1 otetaan yksi merkki 
X cmp.b =$'0',d1 oliko numero? 

blo otettu ei, poistutaan 

cmp.b %'9',d1 

bhi otettu ei, poistutaan 

sub.b $'07,d1 muutetaan ASCII binaariksi 

mulu.w 410,40 kerrotaan tahanastinen tulos 10:l11a 

add.1 d1,d0 lisataan uusi digit 

N bra ota seuraava otetaan seuraava ASCII-merkki 

otettu rts palataan, tulos d0:ssa 


KKKKKKKKKKKKKKKÄKKKKKKKKÄKKKKKEÄKKÄKKKÄKKKKKÄKKÄKKKÄKÄKKÄÄKKÄÄKÄÄÄÄKÄKÄÄKÄKÄÄÄÄÄKKKÄ 


Keskeytysrutiini tarkkailee kayttajan puuhailua. Se vahtii nappai- 
mistorekisteria keyboard, jonka arvo vastaa nappaimistolta viimeksi 
tullutta nappainkoodia (EI ASCIIta!!!). Rutiini tarkkailee myös 
mouse0- ja mousel-paikkoja, joiden arvo muuttuu aina kun hiirta O 
(tavallinen hiiriportti) tai 1 liikutetaan. Rutiini ei havaitse 
hiirien nappaimien naksuttelua. 

Lisaksi tarkkaillaan levyasemien ohjaukseen kaytettavaa rekisteria 
diskctrl, josta voidaan tunnistaa mm. levyaseman paan liikkuminen. 


Jos keskeytysrutiini huomaa jotakin tapahtuneen, se nollaa odotusaika- 
laskurinsa, muuten laskuria kasvatetaan ykkosella. 

Ellei mitaan tapahdu niin pitkaan aikaan, etta laskurin arvo kasvaa 
suuremmaksi kuin ennalta asetettu aikaraja, keskeytysrutiini estaa 
naytto-, Copper- ja Sprite-DMA:n toiminnan. Lisaksi varirekisteriin 
nolla (taustanvari) kirjoitetaan nolla eli musta. 

Kun jotakin taas tapahtuu, DMA:t kytketaan paalle. Koska nayttoa 
sammutettaessa otettiin talteen DMA:n tila, voidaan se palauttaa 


samaksi. HUOM!!! Joku muu ohjelma VOI muuttaa DMA-rekisterin arvoa 
silla aikaa, kun naytto on pimennettyna. Kun tama ohjelma sitten 
sytyttaa nayton, saattaa tapahtua kummia... lienee kuitenkin varsin 


harvinaista, silla yleensa DMA-rekisterin arvoa ei paljon muutella. 


Onneksi tama rutiini palauttaa vain naytto-, Copper- ja Sprite-DMA:n 
ennalleen jattaen aani-, levy- jne. DMA:t muuttamatta. 


* HA 646486444 o 
%* 2 2 A 2626 A X X X A 
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rekisterit talteen 
custom-piirien perusosoite 
nykyinen nappiksen tila 
hiiren tila 

toisen hiiren tila 
levyaseman ohjaustila 
verrataan entista hiiren0 


jos eroa, kayttaja liikuttaa 


verrataan levyas. 


jos eroa, levyasema(t) 


verrataan entista nappiksen 
jos eroa, kayttaja napyttelee 
verrataan entista hiirenl 

jos eroa, kayttaja liikuttaa 


otetaan laskurin arvo 
ylin bitti tarkoittaa: 


kasvatetaan laskuria 
verrataan pimennyksen rajaan 
ei pimenneta viela 


asetetaan tieto: NUKKUU!!! 


move.w DMACONR(a0) ,dmasailo(al) talletetaan entiset DMA- 


introutine push d4-d7 

lea $d£f£000,a0 

move.b keyboard, d4 

move.w mouse0,d5 

move.w mousel,d6 

move.b diskctrl,d7 

cmp.w hiiri0(al),d5 
paikkaa 

bne touhuaa 
hiirta 

cmp.b levyas (al) ,d7 
ohjausrekisteria 

bne touhuaa 
kaytossa 

cmp.b nappis (al) ,d4 
tilaa 

bne touhuaa 

Cmp.w hiiril(al),d6 
paikkaa 

bne touhuaa 
hiirta 
ei puuhaa move.l1 laskuri(al),d0 

bmi nukkuu jo 
NUKKUU! 

addg.l %1,4d0 

cmp.1 raja (al),d0 

blo ei nukkumaan 
nukkumaan bset.1 431,40 

move.l 4d0,laskuri(al) 
bitit 


nukkuu jo 


ei nukkumaan 


touhuaa 
talteen 


move.w 
Clr.w 


$ SAMMUTUS, DMACON (a0) 
COLORO (a0) 


pull d4-47 
moveg.1 0,40 
rts 


move.l 4d0,laskuri(al) 
pull d4-d7 

moveg.1 40,40 

1rts 


move.b 4d4,nappis(al) 


sammutetaan naytto! 
taustanvari mustaksi!! 


rekisterit takaisin 
lippu: keskeytys palveltu 
pois poikkeesa! 


uusi laskurin arvo muistiin 
rekisterit takaisin 

lippu: keskeytys palveltu 
pois poikkeesa! 


nykyinen nappiksen tila 
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move.w 4d5,hiiri0(al) hiiren O tila talteen 
move.w 4d6,hiiril(al) hiiren 1 tila talteen 
move.b 4d7,levyas(al) levyasemien ohjaustila 
talteen 
tst.1 laskuri (al) oltiinko nukkumassa? 
bpl ei herata ei, ei myöskaan herata! 
heratys move.w dmasailo(al),d0 asetetaan entiset DMA:t 
bset.1 f15,4d0 asetuslippu 
move.w <d0,DMACON (a0) kirjoitetaan bitit! 
ei herata clr.1 laskuri (al) nollataan odotusaikalaskuri 
pull d4-d7 rekisterit takaisin 
moveg.1 $1,d0 lippu: keskeytys palveltu 
rts pois poikkeesa! 


KKKKKKKKKKKKKKKKKKKKKKKÄKKKKKÄKKKKKKKÄKKKÄKKKKKKKKKKKKKKÄKÄKÄKÄKKKÄKKKÄKKKÄKÄKKÄ 


Seuraavassa alustetaan keskeytysstructure. Kuten kuvasta nakyy, 
laheskaan kaikkia kenttia ei tarvitse alustaa, vaan homman hoitaa 
Exec. Prioriteetti maaraa, missa jarjestyksessa saman tyyppiset 
keskeytysrutiinit suoritetaan. Silla ei siis ole mitaan tekemista 
prosessorin keskeytysprioriteettien kanssa. Prioriteetti voi olla 
-128...+127, mutta tavallisesti kannattaa kayttaa arvoa 0. 


Type (2) kertoo, etta kyseessa on keskeytysnode. 


tilaa eri tietojen tallentamiseen keskeytysrutiinin aikana. Exec 

lataa data-kentan sisallon al:een ennen keskeytysrutiinin kutsumista. 
Rutiinissa voidaan sitten kayttaa suhteellista osoitusta al:n suhteen, 
mika on paljon nopeampaa kuin absoluuttinen osoittaminen. Ja keskey- 
tysrutiinin tulee olla NOPEA, koska se hidastaa koko koneen toimintaa. 


x 
x 
x 
x 
* 
* 
x 
x 
x 
x 
* 
* 
x 
x 
x 
x 
x 
* server-kentta ilmaisee varsinaisen keskeytysrutiinin alkuosoitteen. 
x 

x 


* 
* 
x 
* 
* 
x 
x 
* 
* 
data-kenttaan on annettu oman 'structuren' osoite, joka sisaltaa * 
* 
x 
x 
*x 
*x 
*x 
* 
x 
x 


KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKÄKKKKKKKKKÄKKKKKKÄKKKKÄKKKKKK 


keskstruc dc.1 [0] ;1n Succ 

do.1 jo) ;1n Pred 

dc.b 2 ;1n Type = NT INTERRUPT 
dc.b o ;1n Pri 

dc.1 intname ;1n Name 

dc.1 IData ; data 

dc.1 introutine ; server 
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KÄKKKKKKKKKÄKKKKKKEÄKKÄKKÄKÄKKÄKKKKÄKKKÄKÄKKKÄKÄKÄKKÄÄKKÄKKKÄÄKKÄÄKKÄKKÄKÄKKÄKKÄKÄÄ 


* 


* Varataan tilaa entisten rekisteriarvojen, 


* 


* 


laskurin jne. tallentamiseen* 


ki 


KKKKKKÄKKKKÄKKKKKKKKKKKKKÄKKKKKKKKKKKÄKKÄKKKKÄKKKKKKKKKUKKKKÄKÄKÄKKKKÄKKKKKKK 


IData dc. 
dc. 
dc. 
dc. 
dc. 
dc. 
dc. 
dc. 


intname dc. 


EEHHEESE 


vanha nappiksen arvc 
vanha hiiren 0 arvo 
vanha hiiren 1 arvo 
vanha levyaseman arvo 
odotettu aika 

000 maksimi odotusaika 
dma-sailo 
varalla 


oO o0voo0o0oo 


'Blanker Interrupt',0 keskeytyksen nimi 


kirjastojen osoittimet, 


nimet 
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Liite F 
Kirjallisuutta 


A vie kaikkien ominaisuuksien täydellinen kuvaaminen yhdessä teoksessa lienee 
tuskin mahdollista. Commodore-Amigakin on tyytynyt tekemään useita konetta ja 
sen ohjelmointia käsitteleviä kirjoja. Lisäksi saatavilla on runsaasti muiden tekijöiden 
teoksia. Assemblerohjelmoinnissa on hyötyä myös yleisistä 68000-sarjan prosessorien oh- 
jelmointia käsittelevistä teoksista. 

Kaikille kirjoille, jotka käsittelevät ohjelmointia, on olemassa yksi yhteinen piirre: Ne 
eivät ole suomenkielisiä. Kirjallisuutta on runsaasti sekä saksaksi että englanniksi, mutta 
ei suomeksi. Niinpä näyttääkin siltä, että ohjelmointi vaatii jonkin verran myös kielten 
opiskelua. 

Seuraavassa luettelossa on esitelty lyhyesti joitakin englanninkielisiä Amigan ohjel- 
moinnissa hyödyksi olevia kirjoja. 

Reference manual -sarja 

ROM Kernel Reference Manual: Exec 

Exec-manuaali esittelee erilaisia käyttöjärjestelmän rakenteita, taskit, signaalit, portit 
ja viestit, keskeytykset, muistin varaamisen, kirjastojen käytön, IFF-formaatin, kirjasto- 
jen offsetit jne. Noin 300 sivua. 

Intuition Reference Manual 

Intuition-käyttäjäliitynnän käyttäminen ohjelmissa. Ikkunat, näytöt, nappulat, valikot, 
syöttö ja tulostus. Esittelyt kaikista Intuition-rutiineista. Noin 300 sivua. Hyvä kirja Intui- 
tionin käyttöä suunnitteleville. 

Hardware Reference Manual 

Copper ja sen ohjelmointi. Näyttöjen luominen suoraan kovoa käyttäen. Spritet. Ääni- 
kovo. Blitter. Liityntäpiirit. I/O- muistikartta. Muistikartta. Näppäimistö. Noin 300 sivua. 
Hyvä kirja, jos aikoo ohjata kovoa ohi käyttöjärjestelmän esimerkiksi peleissä. 

ROM Kernel Reference Manual: Libraries and Devices 

Alemman tason grafiikkarutiinit. Layerit. Animaatio. Tekstin tulostus. 

Audio device, Timer device, Trackdisk device, Console device, Input device, Keybo- 
ard device, Gameport device, Narrator device, Serial device, Parallel device, Printer devi- 
ce ja Clipboard device. Matematiikkarutiinit. Workbench. 

Kaikkien kirjastorutiinien selostukset aakkosjärjestyksessä. Include-tiedostot ja paljon 
muuta. Noin 600 sivua. Melko välttämätön kirja, koska kaikki käyttöjärjestelmän rutiinit 
on esitelty siinä. 

Technical Reference Manual 

Tarpeellista teknistä tietoa niille, jotka haluavat rakentaa Amigaan laajennuskortteja 
tai muita lisälaitteita. Sisältää mm. Amiga-mallien kytkentäkaaviot ja tietoa PC-emulaat- 
torikortista. 
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AmigaDOS Developer's Manual 

Esittelee DOS-rutiinit, makroassemblerin käytön jne. 

Inside Amiga Graphics (kustantaja Compute!) 

Opettaa Amigan grafiikkaa lukuisien esimerkkien avulla. Esimerkkejä Basicilla, C:llä 
ja assemblerilla. 

Amiga Programmer's Handbook, Volume I (SYBEX) 

Amiga Programmer”*s Handbook, Volume II (SYBEX) 

Amigan ohjelmointia, tekijä E. P. Mortimore. 

Programmer's Guide To The Amiga (SYBEX) 

Tekijä Robert Peck, yksi Commodoren Amiga-asiantuntijoista. Kirja kattaa melko hy- 
vin kaikki Amigan ohjelmoinnin osa-alueet. Ohjelmaesimerkkejä on runsaasti ja ne on 
tehty C-kielellä. Kirja ei opeta mitään ohjelmointikieltä, vaan edellyttää, että lukija hallit- 
see jo ainakin C-kielen. Noin 350 sivua. 

Amiga 1, AmigaDos (Jyrki J. J. Kasvi, Tecnopress Oy) 

Amigan käyttöjärjestelmän tarjoamat mahdollisuudet. Käskyvalikoiman laajentami- 
nen. Mukana Käyttäjän oppaasta puuttuvat käskyt. 
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Sananselityksiä 
A 


Agnus Agnus, Denise ja Paula ovat kolme tilaustyönä Amigaan suunniteltua ja valmis- 
ettua mikropiiriä. Ne muodostavat yhdessä suuren, ohjelmoijan kannalta täysin yhtenäi- 
sen kokonaisuuden. Tämä ominaisuuksiltaan jättiläismäinen yksikkö huolehtii Amigan 
äänestä, levyasemista, sarjaväylästä, grafiikasta, väreistä ja animaatiosta. Ilman näiden 
prosessorien apua Amiga olisi melko tavallinen kotimikro (varustettuna moniajolla) vail- 
a poikkeuksellisia ominaisuuksiaan. 

Aliohjelma Katso Rutiini. 

Amiga Commodoren uuden sukupolven mikrotietokone, joka on varustettu tehokkaal- 
a 16/32-bittisellä mikroprosessorilla sekä nopeilla apuprosessoreilla. Amigassa on erit- 
äin kehittyneet ääni- ja grafiikkaominaisuudet, graafinen käyttäjäliityntä, avoin arkkiteh- 
tuuri (hyvä laajennettavuus) ja moniajo. 

Assembler Ohjelma, joka kääntää assembler-kielisen lähdekoodin konekieliseksi, ajet- 
avaksi ohjelmaksi tai linkkerille sopivaksi objektikoodiksi. 

Assembler on myös symbolinen ohjelmointikieli, jossa konekielen käskyille on keksit- 
y niiden toimintaa kuvaavat lyhyet nimet. Ihmisen kannalta nimet ovat selkeämpiä ja hel- 
pompia muistaa kuin konekielen binääriluvut. Assembler-kielen käyttö mahdollistaa 
myös monia muita ohjelman kehittämistä helpottavia toimintoja. kuten symbolisten nimi- 
en (label) käyttämisen ohjelmien ja muistiosoitteiden niminä. 


BCD-luku Binary Coded Decimal. Järjestelmä, jossa yhtä tavua (8 bittiä) käytetään 
tallentamaan kahta kymmenjärjestelmän numeroa. Tavun ylemmät neljä bittiä (ylempi 
nybble) sisältävät enemmän merkitsevän numeron ja alemmat neljä (alempi nybble) vä- 
hemmän merkitsevän numeron. 

BCD-luku on siis väliltä 0...99. 


BCD-luku tavun sisältö hex dec 
00 $00 0 
01 $01 1 
02 $02 2 
09 $09 9 
10 $10 16 
11 $11 17 
12 $12 18 
98 $98 
99 $99 Is 
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Binääriluku 2-järjestelmän luku. Binäärijärjestelmässä käytetään vain lukumerkkejä 
0 ja 1. Nykyiset tietokoneet käyttävät kaikissa toiminnoissaan binäärijärjestelmää. 

Jokaista binääriluvun merkkiä kutsutaan bitiksi. 

Tässä kirjassa binääriluvun tunnuksena on käytetty prosentin merkkiä (%). 

Katso muunnostaulukkoa kohdassa Heksadesimaaliluku. 

Bit Katso Bitti. 

BitMap Katso Bittikartta. 

BitPlane Katso Bittitaso. 

Bitti Binääriluvun numero, ykkönen tai nolla. 

Bittikartta Englanniksi BitMap. Muistialue, jonka jokainen bitti näkyy näytössä tie- 
tyn värisenä pisteenä. Kaikki Amigan näytössä olevat kuvat muodostuvat muistissa ole- 
vista bittikartoista. Bittikartta muodostuu bittitasoista, joita on yksi tai useampia. 

Bittitaso Bittitaso on yksinkertaisesti muistialue, jota käytetään kuvaa muodostettaes- 
sa. 

Moniväriseen kuvaan tarvitaan useita bittitasoja. Esimerkiksi kuva, jossa on kahdek- 
saa väriä, vaatii kolme bittitasoa. Kaikki kolme bittitasoa ovat samankokoisia ja niiden 
voidaan ajatella sijaitsevan päällekkäin. Yhdessä bittitasot muodostavat bittikartan. 

Kun kuvaa piirretään näytölle, jokaista näytön pistettä (pikseliä) varten luetaan jokai- 
sesta bittitasosta samasta kohtaa yksi piste. Näiden kolmen pisteen (jotka muodostuvat 
kukin yhdestä bitistä) muodostama kolmibittinen luku määrää näytöllä näkyvän pisteen 
värin. 32-väriseen kuvaan tarvitaan viisi bittitasoa. 

Itse asiassa bittitasojen bittien muodostama luku ei määrää suoraan kuvaruudun pikse- 
lin väriä, vaan sen värirekisterin numeron, josta varsinainen väri löytyy. Tällä tavoin esi- 
merkiksi 8-väriseen kuvaan voidaan valita vapaasti mitkä tahansa kahdeksan väriä Ami- 
gan 4096 väristä sijoittamalla halutut värit värirekistereihin 0...7. 

Blitter Blitter on grafiikan käsittelyyn suunniteltu osa kolmen tilauspiirin, Agnuksen, 
Paulan ja Denisen muodostamasta kokonaisuudesta. Sen erikoisuuksia ovat mm. nopea 
viivan piirto (noin 1000000 pistettä sekunnissa) ja nelikulmaisten alueiden erittäin nopea 
käsittely. Blitter pystyy lukemaan (lähes) samanaikaisesti tietoa kolmesta paikasta, muo- 
dostamaan niiden välille jonkin 256 loogisesta operaatiosta ja kirjoittamaan tuloksen 
muistiin neljänteen paikkaan. Amigan nopea grafiikka onkin yksinomaan blitterin ansiota. 

Muistinosoitukseen blitter käyttää ns. DMA:ta, joka on nopea tapa hakea muistista tie- 
toa ilman keskusyksikön käyttöä. Siten keskusyksikkö voi hoitaa omia tehtäviään samal- 
la, kun blitter esimerkiksi piirtää näyttöön viivaa. 

Bug, Bugs "Salakavalia ohjelmistovirheitä, jotka tekevät ohjelmoijat hulluksi". Lude, 
hyönteinen. 

Byte Katso Tavu. 

C 

C-128 C-64:n "isoveli", jossa on laajempi muistikapasiteetti, kehittynyt Basic-tulkki, 
80 merkin näyttö ja CP/M-käyttöjärjestelmä sekä C-64-tila. 

C-16 C-64:stä suunniteltu yksinkertaistettu malli, joka kuitenkin sisältää kehittyneem- 
män Basic-tulkin. 

C-64 Kaikkien aikojen menestyksekkäin ja eniten myyty tietokone. Markkinoille tul- 
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lessaan C-64 oli kehittynyt ja suurella muistikapasiteetilla varustettu kone, joka on nyt 
muodostunut maailmanlaajuiseksi standardiksi. Edelleen hyvin suosittu mikro, vaikka 16- 
bittiset koneet ovatkin tulleet jäädäkseen. 

Cat Katso Kissa. 

CHIP-RAM Muistialue 0...512k ($00000000...800080000). Amigan apuprosessorit 
Agnus, Paula ja Denise pystyvät tällä hetkellä käyttämään vain tätä muistialuetta. Siksi 
kaikki tieto kuvia, ääntä jne. varten on sijoitettava tälle alueelle, jotta apuprosessorit voisi- 
vat käyttää sitä. 

Koska myös apuprosessorit käyttävät CHIP-RAM-muistia, joutuu keskusyksikkö toisi- 
naan odottamaan vuoroaan muistia käyttäessään. Tämä hidastaa keskusyksikköä jonkin 
verran. 

Jos Amigassa on vain 512k muistia, se on kokonaan CHIP-RAM-tyyppistä. 

Katso myös FAST-RAM. 

Clock Freguency Katso Kellotaajuus. 

Compiler Katso Kääntäjä. 

Copper Copper eli Co-Processor on yksinkertainen, mutta nopea apuprosessori. Sen 
tehtävänä on päivittää näyttöön liittyviä asetuksia reaaliajassa. Copperin toiminta on tah- 
distettu näytön elektronisuihkun paikkaan. Copper hoitaa väripaletin muuntelun, spritejen 
käsittelyn, tarvittaessa jopa kuvaruudun vierityksen. Esimerkiksi kuvaruudulla näkyvät 
näytöt (screen) ovat Copperin ansiota. Näyttöjen välillä vaakasuunnassa olevan kolme 
pikseliriviä korkean juovan piirtämisen aikana Copper vaihtaa näytön värit, resoluution, 
spritet, sijainnin muistissa jne. alempaa näyttöä vastaaviksi. Copper voi myös ohjata blit- 
teriä. 

Vaikka Copper hallitsee vain kolme käskyä (Move, Wait ja Skip), se on niin tehokas, 
että tavallisen 8-bittisen mikroprosessorin teho ei riittäisi korvaamaan sitä. 

Copper on osa kolmen tilauspiirin, Agnuksen, Paulan ja Denisen muodostamaa suurta 
kokonaisuutta. 

Koska Copper käyttää ohjelmansa hakemiseen DMA-osoitusta, keskusyksikön toimin- 
ta ei häiriinny Copperin ollessa käynnissä. 

Crackeri Henkilö, joka murtaa kaupallisten ohjelmien kopiointisuojauksia ja saattaa 
ohjelmia yleiseen levitykseen. 


Demo Pitkähkö ohjelma, jolla ohjelmien levittäjät (swapper), crackerit ja Amiga-käyt- 
täjäryhmät pyrkivät jäämään yleisön mieliin. Ohjelmilla ei yleensä ole mitään varsinaista 
käyttötarkoitusta, mutta ne ovat varsin näyttäviä. 

Denise Katso Agnus. 

DMA Lyhenne sanoista Direct Memory Access eli suora muistiosoitus. Tavallisesti 
jonkin apupiirin tarvitessa tietoa ao. piiri kertoo asiasta koneen keskusyksikölle, joka hoi- 
taa varsinaisen tiedon siirtämisen. Amigassa kuitenkin käytetään runsaasti ns. DMA-osoi- 
tusta, jossa tietoa tarvitseva piiri hakee itse automaattisesti tiedon muistista häiritsemättä 
keskusyksikön toimintaa. Amigan apuprosessorit käyttävät DMA-osoitusta mm. kuvan ja 
äänen tuottamiseen sekä levyasematoimintoihin. Siten keskusyksikkö on vapaa hoita- 
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maan muita tehtäviä esimerkiksi digitoidun musiikin soidessa ja tiedostolohkon latautues- 
sa muistiin levykkeeltä. 

DRAM Lyhenne sanoista Dynamic Random Access Memory. RAM-tyyppi, jossa tie- 
don varastoiminen perustuu pieniin kondensaattoreihin (kuin pikkuruisia akkuja), joita 
varataan tai puretaan riippuen niihin tallennetusta tiedosta (ykkönen tai nolla). Koska kon- 
densaattorit pyrkivät vähitellen tyhjenemään, on niiden varaustila uudistettava tietyin vä- 
lein, jotta tieto säilyisi. Tätä tapahtumaa kutsutaan virkistämiseksi. 

DRAM-tekniikalla valmistetaan nykyisin muistikapasiteetiltaan suurimmat RAM- 
muistit. Amigoissa käytetään tällä hetkellä 256 kilobitin (262144 bittiä) DRAM-piirejä. 
Yleisessä käytössä on jo kuitenkin myös 1 megabitin piirejä. 


E 


EEPROM ihon sanoista Electrically E Erasable RES aäsle N Read aal Kenny 
(sähköisesti pyyhittävä ja ohjelmoitava lukumuisti). EEPROM-muisti voidaan pyyhkiä ja 
ohjelmoida uudelleen sähköisesti. Ohjelmointikertojen määrä on rajallinen, n. 10000. Oh- 
jelmointi on hidasta verrattuna RAM-muistiin. EEPROM-muistin tiedot säilyvät jännite- 
katkoista huolimatta. 

EEPROM-muistia käytetään joissakin laitteissa tallentamaan tiettyjä käyttäjän tekemiä 
asetuksia, jolloin ne säilyvät myös laitteen ollessa jännitteettömänä. 

EPROM Lyhenne sanoista Electrically Programmable Read Only Memory (sähköises- 
ti ohjelmoitava lukumuisti). Yleensä EPROM-muistilla tarkoitetaan lukumuistia, joka voi- 
daan pyyhkiä UV-valoa käyttäen ja ohjelmoida uudelleen. Ohjelmointikertojen lukumää- 
rä on rajallinen, yleensä n. 30. Ohjelmointi on hidasta verrattuna RAM-muistiin. Katso 
myös ROM. 

Exception Poikkeustila 68000-sarjan prosessoreiden ohjelman suorituksessa. Excepti- 
on-tila aiheutuu joko keskeytyksestä, virheestä tai CHK/TRAPV-käskyistä. Virheet ja 
em. käskyt aiheuttavat normaalisti Amigassa gurun vierailun, ellei jokin ohjelma käsittele 
itse ao. virhetiloja. 

Tästä tilasta palataan RTE- (Return From Exception) käskyllä. 

Extra Halfbrite Amigan grafiikan erikoistila, jossa näytölle saadaan samanaikaisesti 
64 väriä, vaikka Amigan grafiikkakovo sisältää nykyisin vain 32 värirekisteriä. 

Toiminta perustuu siihen, että kaikkien värirekisterien väreistä on käytettävissä myös 
puolta himmeämpi väri (siitä nimi halfbrite). Järjestelemällä värit sopivasti saadaan tätä 
moodia käyttämällä parempia kuvia kuin tavallisesti 32 väriä käyttäen. 


F 


FAST-RAM Kaikki RAM-muisti, = sijaitsee osoitteen 800080000 yläpuolella. Jos 
Amigassa on yli 512k muistia, yli menevä osa on FAST-RAM-tyyppistä. 

Koska apuprosessorit eivät voi osoittaa (=käyttää) FAST-RAM-muistialuetta, on kes- 
kusyksiköllä jatkuvasti esteetön pääsy sinne. Siksi muistia kutsutaankin nimellä FAST 
(=nopea). FAST-RAM-muistissa ohjelmien toiminta on jonkin verran nopeampaa kuin 
CHIP-RAM:ssa. 

Kaikki grafiikkaan ja ääneen yms. liittyvä tieto on sijoitettava CHIP-RAM-alueelle, 
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jotta apuprosessorit voisivat sitä käyttää. 

Katso myös CHIP-RAM. 

Fred Fish "Fairly Famous, Foremost Finder of Fine Floppies For Free". Tunnetuin 
Amigan PD-ohjelmien kokooja. FISH-levykkeitä on olemassa jo yli 180. 


H 


Hackeri Tietokoneviestinnän harrastaja. Siirtää viestejä ja ohjelmia elektronisten pos- 
tilaatikoiden välityksellä. Jotkut hackerit ovat herättäneet negatiivista huomiota murtautu- 
malla sellaisiin tietokoneverkkoihin, joihin ulkopuolisten pääsy on pyritty estämään. 

HAM Lyhenne sanoista Hold-And-Modify. Amigan grafiikan erikoistila, jossa näyt- 
töön saadaan samanaikaisesti jopa 4096 väriä. Perustuu siihen, että edellisen pikselin vä- 
riä muokataan halutulla tavalla seuraavaa pikseliä varten. Koska värin täydellinen (kaikki- 
en punaisen, sinisen ja vihreän komponentin) muuntaminen vaatii useamman pikselin 
matkan (kahden pikselin välisenä aikana voidaan muuttaa vain yhtä värikomponenttia), 
HAM-kuvissa värien rajat eivät voi olla kovin teräviä. 

Hard Disk Katso Kovalevyasema. 

Heksadesimaaliluku 16-järjestelmän luku. Heksadesimaali järjestelmässä käytetään 
merkkejä 0...9 ja a...f ilmaisemaan 10-järjestelmän lukuja 0...15. Tässä kirjassa heksa- 
desimaalilukujen tunnuksena on käytetty dollari-merkkiä ($). Muunnostalukko: 


desimaali heksa oktaali binääri 
0 $00 &000 HAO00000000 
1 $01 &001 %00000001 
2 $02 &002 %00000010 
3 $03 &003 H%O00000011 
4 $04 &004 %00000100 
5 $05 &005 %00000101 
6 $06 &006 %00000110 
7 $07 &007 % 00000111 
8 $08 &010 % 00001000 
9 $09 &011 00001001 
10 $0a &012 00001010 
11 $0b &013 %00001011 
12 $0c &014 00001100 
13 $01 &O015 % 00001101 
14 $02 &016 %00001110 
15 $03 &017 H00001111 
16 $04 &020 % 00010000 
LT. $11 &021 %00010001 


Hertsi Yksi värähdys sekunnissa. 

Hiiret Eläintiet.: Hiirten ja rottien heimoon (Muridae) kuuluvia pieniä jyrsijöitä, joilla 
on suipohko kuono, isot korvat ja suunnilleen ruumiin pituinen häntä. Eläin, jota kissat 
erityisen mielellään jahtaavat. Pitää juustosta. Voidaan pyydystää hiiren loukulla (Mouse 
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Trap). 

Tietokonetekn.: Pieni rasia, johon kuuluu yhdestä kolmeen näppäintä. Rasian alla on 
tavallisesti pieni pallo, joka pyörii, kun rasiaa liikutetaan esim. pöydällä. Pallon pyörimi- 
nen tunnistetaan ja tieto välitetään tietokoneelle. Näin voidaan hiirtä liikuttelemalla saada 
aikaan vastaava liike kuvaruudulla vaikkapa piirto-ohjelmassa. 

Amigan hiiri on toimintaperiaatteeltaan optomekaaninen ja ilmaisee liikkeen pallon 
avulla. Pallo pyörittää kahta rullaa, jotka puolestaan pyörittävät ropeleita, joiden pyörimi- 
nen ilmaistaan ns. optohaarukan avulla. Optohaarukka muodostuu valon lähteestä ja va- 
lolle herkästä diodista. Pyörivä ropeli varjostaa diodia, jonka antamat pulssit vahvistetaan 
ja johdetaan Amigan Paula-piirin laskettaviksi. 


Include-tiedosto Tiedosto, jossa tavallisesti määritellään joitakin ohjelmaan liittyviä 
muistiosoitteita, vakioita jne. Kääntäjä lukee include-tiedoston osana kääntämisprosessia. 
Jos samoja vakioita tarvitaan useissa ohjelmissa, kannattaa vakiot koota include-tie- 

dostoihin. Niihin ohjelmiin, jotka tarvitsevat ao. vakioiden määrittelyjä, sijoitetaan vain 
include-komento, joka lukee halutun include-tiedoston kääntämisen aikana. Tämä menet- 
tely säästää levyketilaa, koska vakioiden määrittelyä ei tehdä erikseen jokaisessa ohjel- 
massa. 

Interlace Amigan grafiikan tila, jossa vain joka toinen näytön vaakajuovista piirretään 
yhtä kuvaa muodostettaessa. Siten koko kuva piirretään vain 25 kertaa sekunnissa ta- 
vanomaisen 50 kerran sijasta. Tämä aiheuttaa joissakin monitoreissa häiritsevää välkky- 
mistä. 

Samaa tekniikkaa käytetään eurooppalaisessa TV-standardissa. Sen avulla Amigan 
grafiikan pystysuunnan maksimiresoluutio saadaan nostettua 256:sta 512 pikseliin eli TV- 
kuvan tasolle. 

Koska Amiga käyttää samaa näytön virkistystaajuutta kuin TV, voidaan Amigan kuva 
helposti yhdistää esimerkiksi videokuvan kanssa ja siten vaikkapa tekstittää videonauho- 
ja Amigan ja Genlock-laitteen avulla. 

Intro Lyhyehkö ohjelma, joita ohjelmien levittäjät ja crackerit liittävät levittämiensä 
ohjelmien alkuun tiedottamaan yleisölle, kenen ansiota ko. ohjelman levittäminen on. Int- 
ro on lyhyempi ja vaatimattomampi kuin demo. 


Kellotaajuus Kellotaajuus määrää tietokoneen toimintanopeuden. Mikroprosessori 
suorittaa kaikki toimintansa kellotaajuuden määräämällä nopeudella. Periaatteessa kello- 
taajuuden kaksinkertaistaminen nostaa koneen tehon kaksinkertaiseksi. Ongelmana on 
kuitenkin mm. muistien rajallinen nopeus. 

Amigan keskusyksikön kellotaajuus on 7.14 MHz, mutta joidenkin turbokorttien avul- 
la keskusyksikkö voi toimia esimerkiksi 14,3 MHz:n taajuudella. 
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Kiintolevy Katso Kovalevyasema. 

Kirjasto Kokoelma tiettyyn aihepiiriin liittyviä käyttöjärjestelmärutiineja. Kaikkien 
saman kirjaston rutiinien kutsuosoitteet ovat suhteellisia kirjaston perusosoitteeseen. 

Kissa Hiiren paras ystävä. Ainakin siitä päätellen, että se pyrkii aina läheiseen koske- 
tukseen hiirten kanssa. 

Kovalevyasema Vastaa toimintaperiaatteeltaan tavallista levyasemaa, mutta sisältää 
ohuen muovisen levykkeen sijasta suljetussa kotelossa useita alumiinista valmistettuja, 
magneettisella materiaalilla päällystettyjä levyjä. 

Kovalevyn pyörimisnopeus on esim. 3000 kierrosta minuutissa (tavanomaisen 300 
kierroksen sijasta) ja se pyörii jatkuvasti. Luku-kirjoituspään siirtonopeus myös paljon 
suurempi kuin tavallisissa levyasemissa, joten kovalevy on huomattavasti nopeampi. 

Kovalevyn tallennustiheys ja levyjen määrä on suuri. Niinpä kovalevyjen kapasiteetit 
vaihtelevatkin kymmenistä satoihin megatavuihin. 

Käyttöjärjestelmä Tietokoneen sisältämä aliohjelmakirjasto, jonka avulla tietokone 
käynnistyy ja joka tarjoaa ohjelmille valmiin toimintaympäristön. Esimerkiksi Amigan 
käyttöjärjestelmä sisältää yli 400 aliohjelmaa eli rutiinia, joita käyttäen eri ohjelmat voi- 
vat hallita konetta (lukea tietoa levykkeiltä, tulostaa tekstiä kuvaruutuun jne). 

Ilman käyttöjärjestelmää jokaiseen ohjelmaan pitäisi sisältyä kaikki matemaattiset ja 
graafiset aliohjelmat, levyasemien ohjausrutiinit jne. 

Kääntäjä Ohjelma, joka muuntaa lähdekoodin jollekin muulle kielelle, esimerkiksi as- 
sembler- ja C-kääntäjät. Kääntäjän nimi ilmaisee tavallisesti lähdekielen nimen, kääntä- 
jän tuottama koodi on tavallisesti konekieltä tai linkkerin käyttämää objektikoodia. 


L 


Library Katso Kirjasto. 

Linkkeri Ohjelma, joka liittää C- ja/tai assembler-kääntäjällä käännetyt palaset yhteen 
muodostaen niistä ajettavan ohjelman. Esimerkiksi ALINK ja BLINK. 

Long Katso Pitkä sana. 

Long Word Katso Pitkä sana. 

Lukujärjestelmät Katso Heksadesimaali-, Binääri- ja Oktaaliluvut. 


Makro Usein tarvittavan lyhyehkön käskyryhmän korvaaminen symbolisella nimellä. 
Makrojen käyttö helpottaa ohjelmointityötä ja selkeyttää ohjelmalistausta. Toisaalta mak- 
roja käyttäen tehty ohjelma voi olla pitempi kuin tavallinen. Lisää tietoa assemblerkääntä- 
jää esittelevässä osassa. 

Megahertsi Miljoona hertsiä (mega = 1000000) eli miljoona värähdystä sekunnissa. 

MHz Katso Megahertsi. 

Mode Katso Moodi. 

Modeemi Lyhenne sanoista MOdulator/DEModulator. Laite, jonka avulla tietokone 
voidaan kytkeä tavanomaisen puhelinverkkoon tietojen siirtämistä varten. Nykyisin Suo- 
messakin on suuri joukko ns. bokseja, joista voi hankkia ohjelmia ja joihin voi esim. jät- 
tää kysymyksiä muiden vastattaviksi. Modeemin avulla voi siirtää elektronista postia ja 
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esimerkiksi tarkistaa tilitietonsa pankista. 

Modeemien nopeudet vaihtelevat 300...19200 bps (bittiä sekunnissa). Tällä hetkellä 
suosituimpia ovat 1200 bps ja 2400 bps mallit. 

Modem Katso Modeemi. 

Monitori Näyttölaite. johon kuuluu periaatteessa sama elektroniikka kuin televisioon, 
mutta josta puuttuu itse vastaanotinosa. Käytetään tietokoneiden näyttönä. mihin se suu- 
remman erottelukykynsä vuoksi sopii paremmin kuin tavallinen TV. 

Monitori on myös ohjelma, jonka avulla voidaan tutkia ja muuttaa tietokoneen muistin 
sisältöä. Kehittyneimpien monitoriohjelmien avulla voidaan jopa kääntää assemblerkielis- 
tä ohjelmaa konekielelle ja päinvastoin. 

Moniajo Useiden ohjelmien suorittaminen (näennäisesti) samanaikaisesti. Moniajo 
helpottaa työskentelyä, koska esimerkiksi tekstieditoreja voi olla samanaikaisesti käytös- 
sä useita. Tausta-ajona saattaa lisäksi pyöriä assemblerkääntäjä ja lukuisia apuohjelmia. 
Ohjelmien välillä on nopea liikkua siirtymällä ikkunasta toiseen sen sijaan, että olisi aina 
ladattava koneeseen uusi ohjelma, kuten Amigan ns. kilpailijassa. 

Moniajosta on kuitenkin apua vain hyötykäytössä, sillä useimmat pelit aivät salli mo- 
niajon toimintaa. 

Moniajo vaatii koneelta ja käyttöjärjestelmältä paljon. Käyttöjärjestelmän tekeminen 
moniajokoneeseen on huomattavasti vaikeampaa kuin tavallisesti. Myös keskusyksikön 
tehon on oltava suurempi. 

Amigassa, kuten kaikissa yksiprosessorisissa moniajokoneissa, ajetaan "samanaikai- 
sesti" pyöriviä ohjelmia vuorotellen niin nopeasti vaihdellen, että syntyy vaikutelma oh- 
jelmien samanaikaisesta toiminnasta. Amigan käyttöjärjestelmä on todellinen moniajosys- 
teemi, sillä yhtä aikaa ajettavien ohjelmien lukumäärää ei rajoita muu kuin vapaan muis- 
tin määrä. 
Moodi Toimintatapa. Esimerkiksi piirtomoodi määrää tavan, jolla grafiikka (viivat, 
teksti) tulostetaan kuvaan. 

Mouse Katso Hiiret. 
Multitasking Katso Moniajo. 


Nybble Tavun puolikas, joko ylemmät tai alemmat neljä bittiä (siis bitit 0...3 tai 4...7). 


Offset Offset ilmaisee poikkeman tietystä arvosta. Ohjelmoinnissa offset ilmaisee koh- 
deosoitteen eron tiettyyn perusosoitteeseen verrattuna. Jos esimerkiksi osoiterekisteri a0 
sisältää osoitteen $00dff000 (Amigan apuprosessorien alkuosoite), voidaan värirekisteriä 
0 osoitettaessa käyttää offset-arvoa $180, koska ao. värirekisteri sijaitsee osoitteessa 
$00dff180. Tällöin käytettävä osoitusmuoto olisi $180(a0). 

Ohjelmistot Paikkoja, joissa Bugit elävät. 

Oktaaliluku 8-järjestelmän luku. Oktaalijärjestelmässä käytetään vain lukumerkkejä 
0...7. Tässä kirjassa oktaalilukujen tunnuksenä on käytetty &-merkkiä. 

Katso muunnostaulukkoa kohdassa Heksadesimaaliluku. 
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Operating System Katso Käyttöjärjestelmä. 

Osoitin Osoitin johonkin kohteeseen (structure. muistipaikka, merkkijono jne.). Useil- 
le rutiineille annetaan lähdetietoina yksi tai useampia osoittimia, jotka kertovat, mistä var- 
sinainen tieto löytyy. Jotkut rutiinit myös palauttavat tuloksena osoittimen johonkin struc- 
tureen (esim. Open Window). 

Osoittimeksi kutsutaan myös kuvaruudulla näkyvää nuolta, joka liikkuu hiirtä liikutet- 
taessa. 


P 


Paula Katso Agnus. 

PD-ohjelma Lyhenne sanoista Public Domain. Ohjelma, jota saa vapaasti levittää 
edellyttäen, ettei kopioinnista peritä muuta maksua kuin suoranaiset kulut. 

Pikseli Näytöllä näkyvä grafiikan pienin piste, joita Amigan näyttöön mahtuu jopa 
327680 kappaletta. 

Pitkä sana 32-bittinen luku (Long tai Long word). joka siis muodostuu neljästä tavus- 
ta. Jokainen neljällä jaollinen osoite n sisältää pitkän sanan eniten merkitsevän tavun, 
n+1 toiseksi eniten merkitsevän jne. 68000-prosessori vaatii, että sanat ja pitkät sanat si- 
jaitsevat aina parillisissa osoitteissa. 

Pointer Katso Osoitin. 


R 


RAM Lyhenne sanoista Random Access Memory (hajasaantimuisti). RAM-muisti on 
tietokoneessa hyvin tärkeä, koska kaikki käsiteltävät tiedot tallennetaan siihen. RAM- 
muistiin voi kirjoittaa rajattomasti uutta tietoa. Tieden kirjoittaminen on yhtä nopeaa kuin 
lukeminenkin. Tiedot katoavat, kun muistilta katkaistaan käyttöjännite. 

Resoluutio Suurin mahdollinen pikselien määrä vaaka- ja pystysuunnassa kuvaruudus- 
sa. Amigassa näytön paras resoluutio ilman lisäkortteja on 640 x 512 pikseliä. 

ROM Lyhenne sanoista Read Only Memory (lukumuisti). ROM-muisti voidaan ohjel- 
moida vain kerran ja sitä käytetään esimerkiksi käyttöjärjestelmärutiinien tallentamiseen. 
ROM-muistin sisältö ei häviä, vaikka jännite katkaistaisiin. Usein ROM-muistit on ohjel- 
moitu valmiiksi jo niitä ohjelmoitaessa. 

Rutiini Aliohjelma. Ohjelman (käyttöjärjestelmän tms.) osa, joka suorittaa tietyn toi- 
minnan ja palaa kutsuneeseen ohjelmaan. Rutiineja ovat esimerkiksi Read ja Write, jotka 
lukevat tietoa tiedostoista ja kirjoittavat niihin. 


S 


Sana 16-bittinen luku (Word). Jokainen parillinen muistiosoite sisältää sanan ylem- 
män puoliskon ja sitä seuraava pariton osoite alemman puoliskon. 68000-prosessori vaa- 
tii, että sanat ja pitkät sanat sijaitsevat aina parillisissa osoitteissa. 

Software Katso Ohjemistot. 

SRAM Lyhenne sanoista Static Random Access Memory. RAM-tyyppi, jossa tieto va- 
rastoidaan ns. kiikkuihin, jotka muodostuvat 2...4 transistorista. Tällä tavoin tallennettu 
tieto ei tarvitse virkistystä DRAM-piirien tavoin, mutta monimutkaisemman rakenteensa 
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vuoksi SRAM-muistit ovat kapasiteetiltaan pienempiä ja kalliimpia. Nopeimmat RAM- 
muistit ovat SRAM-tyyppisiä. 

Stack Pinomuisti, prosessorin työalue. Pinomuisti on osa tavallista RAM-muistia, mut- 
ta sitä osoitetaan erityisen pino-osoittimen (Stack Pointer, SP) avulla. Pinomuistille on 
tyypillistä, että siihen viimeksi tallennettu luku otetaan siitä ensimmäisenä pois (LIFO, 
Last In - First Out). Pinomuistia käytetään lähinnä tallennettaessa aliohjelmaa kutsuttaes- 
sa paluuosoite ja tarvittaessa tilapäistä työtilaa aliohjelmassa, joka voi kutsua itseään. 

Structure Kokoelma samaan asiaan liittyviä muuttujia, jotka voivat olla keskenään eri 
tyyppiä. Kokoelman kaikki muuttujat esiintyvät aina yhdessä samassa järjestyksessä. 
Kaikkien muuttujien koko pysyy aina samana (merkkijono ei siis voi olla osa structurea). 
Em. seikkojen vuoksi jokaisen structuren muuttujan paikan tietämiseksi tarvitsee tietää 
vain structuren osoite (joka on sama kuin ensimmäisen muuttujan osoite) ja eri muuttuji- 
vain structuren alkuosoite. 

Esimerkiksi OpenWindow-rutiinille annetaan niin paljon tietoja ikkunaa varten, ettei- 
vät ne kaikki mahtuisi prosessorin rekistereihin. Siksi on käytännöllisempää antaa rutiinil- 
le vain tietyn structuren (tässä tapauksessa New Window) alkuosoite, joka vaatii vain yh- 
den prosessorin rekisterin käyttöä. 

Swapperi Henkilö, joka on kiinnostunut tietokoneohjelmien vaihtamisesta. Nykyään 
mm. Amiga-swapperit vaihtavat paljon ohjelmia myös ulkomailta. Heidän ansiostaan uu- 
simmat ohjelmat ovat käyttäjien ulottuvilla jo ennen niiden varsinaista esittelyä Suomes- 
sa. 

Swapperien haittapuolena on, että ohjelmien kehittämisen kannattavuus saattaa muut- 
tua kyseenalaiseksi, koska nykyään yhä harvemmat ostavat alkuperäisiä ohjelmia. 


T 


Task Tehtävä. Tietokonetekniikassa jokin tietokoneessa pyörivistä ohjelmista. Ami- 
gassa taskeja ovat myös jotkin käyttöjärjestelmän sisäiset toiminnot (devicet). 

Tavu 8-bittinen luku (Byte). Yksi muistiosoite sisältää yhden tavun tietoa. Tavut voi- 
vat sijaita parillisissa tai parittomissa osoitteissa. 

Turbo Tietokonetekniikassa: Yleensä apukortti, jonka avulla koneen tehoa saadaan 
kasvatetuksi. Esimerkiksi Amigan 68000-prosessori voidaan korvata kortilla, jolla on täy- 
sin 32-bittinen 68020-prosessori ja 68881-aritmetiikkaprosessori. Turbokortin kellotaa- 
juus voi myös olla alkuperäistä suurempi, esim. kaksinkertainen. Kun 68020-prosessoriin 
vielä lisätään nopeaa 32-bittistä muistia, Amigan teho saadaan helposti 4...6-kertaistettua. 

Turbo-kortit aiheuttavat yhteensopivuusongelmia, koska 68000- ja 68020-prosessori- 
en välillä on tiettyjä eroja. Yleensä hyötyohjelmat toimivat normaalisti, mutta pelit eivät. 


Vector Katso Vektori. 

Vektori Ohjelmoinnissa: Osoitin johonkin kohteeseen (yleensä aliohjelmaan). 

Grafiikassa: Suora viiva. Esimerkiksi vektorigrafiikka tarkoittaa pelkistä viivoista piir- 
rettyä grafiikkaa, jonka tuottaminen on erittäin nopeaa. 
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VIC-20 Ensimmäinen kotimikro, jossa oli kunnollinen näppäimistö, ääni ja värit. 
Aloitti Commodoren suosittujen tietokoneiden sarjan. Nykyään VIC on monin paikoin 
muuttumassa keräilyharvinaisuudeksi. 

Word Katso Sana. 
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Amiga 3 on kirja, josta on hyötyä kaikille Amigaa ohjel- 
moiville. Ensisijaisesti kirja on tarkoitettu assemblerkielellä 
ohjelmoiville tai ohjelmointia aloitteleville. 


Kirja esittelee MC68000-prosessorin rakenteen, sen käsky- 
kannan ja assemblerkääntäjien käytön. Samoin käsitellään 
käyttöjärjestelmärutiinien kutsumista ja tarkastellaan tär- 
keimpien käyttöjärjestelmärutiinien toimintaa ja käyttöä. 


Mukana seuraavalla levykkeellä on monipuolinen konekieli- 
monitori, assemblerin include-tiedostot kirjoittajan tekemine 
makroineen sekä esimerkkiohjelmia. 


Kirjan kirjoittaja on ohjelmoinut Amigaa assembler: ja 
C-kieliä käyttäen yli kaksi vuotta. 
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